# .NET 代码示例
<a name="CodeSamples.DotNet"></a>

**Topics**
+ [.NET：设置 AWS 凭证](#CodeSamples.DotNet.Credentials)
+ [.NET：设置 AWS 区域和端点](#CodeSamples.DotNet.RegionAndEndpoint)

本指南包含 .NET 代码片段以及可现成运行的程序。可以在以下章节中找到这些代码示例：
+ [使用 DynamoDB 中的项目和属性](WorkingWithItems.md)
+ [使用 DynamoDB 中的表和数据](WorkingWithTables.md)
+ [在 DynamoDB 中查询表](Query.md)
+ [在 DynamoDB 中扫描表](Scan.md)
+ [在 DynamoDB 中使用二级索引改进数据访问](SecondaryIndexes.md)
+ [在 DynamoDB 中使用 .NET 文档模型](DotNetSDKMidLevel.md)
+ [结合使用 .NET 对象持久化模型和 DynamoDB](DotNetSDKHighLevel.md)
+ [将更改数据捕获用于 DynamoDB Streams](Streams.md)

可以使用 适用于 .NET 的 AWS SDK 和 Toolkit for Visual Studio 快速入门。

**运行 .NET 代码示例（使用 Visual Studio）**

1. 下载并安装 [Microsoft Visual Studio](https://www.visualstudio.com)。

1. （可选）下载并安装 [Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/)。

1. 设置您的 AWS 凭证。在您的共享 AWS 凭证文件 (`~/.aws/credentials`) 中配置凭证配置文件。有关更多信息，请参阅《适用于 .NET 的 AWS SDK 开发人员指南》**中的[配置 AWS 凭证](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html)。

1. 启动 Visual Studio。依次选择**文件**、**新建**、**项目**。

1. 搜索**控制台应用程序**，选择以 .NET 为目标的 C\$1 模板，然后选择**下一步**。配置您的项目名称和位置，然后选择**创建**。

1. 将适用于 DynamoDB 的 AWS SDK NuGet 程序包添加到项目中：

   1. 在解决方案资源管理器中，打开项目的上下文（右键单击）菜单，然后选择**管理 NuGet 程序包**。

   1. 在 NuGet 程序包管理器中，选择**浏览**。

   1. 在搜索框中输入 **AWSSDK.DynamoDBv2**，等待搜索完成。

   1. 选择 **AWSSDK.DynamoDBv2**，然后选择**安装**。

1. 在 Visual Studio 项目中，打开 `Program.cs`。用要运行的文档页中的代码示例替换内容。

1. 要运行代码，请在 Visual Studio 工具栏中选择**开始**。

适用于 .NET 的 SDK 提供线程安全的客户端来处理 DynamoDB。应用程序应创建一个客户端并在线程之间重复使用此客户端，您应将此作为一项最佳实践。

有关更多信息，请参阅 [AWS SDK for .NET](https://aws.amazon.com/sdk-for-net)。

**注意**  
本指南中的代码示例旨在用于最新版本的 适用于 .NET 的 AWS SDK。

## .NET：设置 AWS 凭证
<a name="CodeSamples.DotNet.Credentials"></a>

适用于 .NET 的 SDK 要求在运行时向应用程序提供 AWS 凭证。本指南中的代码示例假定使用 SDK 存储来管理 AWS 凭证文件，如《适用于 .NET 的 AWS SDK 开发人员指南》**的[使用 SDK 存储](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html#sdk-store)所述。

Toolkit for Visual Studio 支持来自任意数量账户的多组凭证。每组凭证称为一个*配置文件*。Visual Studio 将条目添加到项目的 `App.config` 文件，这样应用程序可在运行时查找 AWS 凭证。

下面的示例显示使用 Toolkit for Visual Studio 创建新项目时生成的默认 `App.config` 文件。

```
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
    <add key="AWSProfileName" value="default"/>
    <add key="AWSRegion" value="us-west-2" />
 </appSettings>
</configuration>
```

运行时，程序使用 `AWSProfileName` 条目所指定的 `default` 组 AWS 凭证。AWS 凭证以加密形式保存在 SDK Store 中。Toolkit for Visual Studio 提供一个图形用户界面，用于在 Visual Studio 中管理凭证。有关更多信息，请参阅《AWS Toolkit for Visual Studio 用户指南》**的[指定凭证](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/tkv_setup.html#creds)。

**注意**  
代码示例默认访问美国西部（俄勒冈）区域的 DynamoDB。可以通过修改 App.config 文件的 `AWSRegion` 条目更改区域。可以将 `AWSRegion` 设置为 DynamoDB 可用的任何区域。有关完整列表，请参阅《Amazon Web Services 一般参考》中的 [AWS 区域和终端节点](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region)**。

## .NET：设置 AWS 区域和端点
<a name="CodeSamples.DotNet.RegionAndEndpoint"></a>

代码示例默认访问美国西部（俄勒冈）区域的 DynamoDB。可以修改 `App.config` 文件中 `AWSRegion` 条目更改区域。或者，可以修改 `AmazonDynamoDBClient` 属性更改区域。

下面的代码示例实例化一个新的 `AmazonDynamoDBClient`。修改客户端，对其他区域的 DynamoDB 运行该代码。

```
AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// This client will access the US East 1 region.
clientConfig.RegionEndpoint = RegionEndpoint.USEast1;
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);
```

有关区域的完整列表，请参阅《Amazon Web Services 一般参考》中的 [AWS 区域和终端节点](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region)**。

如果要使用 DynamoDB在计算机本地运行代码示例，请按如下方式设置端点。

```
AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// Set the endpoint URL
clientConfig.ServiceURL = "http://localhost:8000";
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);
```