View a markdown version of this page

.NET 代码示例 - Amazon DynamoDB
.NET：设置 AWS 凭证.NET：设置 AWS 区域和端点

.NET 代码示例

本指南包含 .NET 代码片段以及可现成运行的程序。可以在以下章节中找到这些代码示例：

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

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

  1. 下载并安装 Microsoft Visual Studio。

  2. （可选）下载并安装 Toolkit for Visual Studio。

  3. 设置您的 AWS 凭证。在您的共享 AWS 凭证文件 (~/.aws/credentials) 中配置凭证配置文件。有关更多信息，请参阅《适用于 .NET 的 AWS SDK 开发人员指南》中的配置 AWS 凭证。

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

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

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

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

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

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

    4. 选择 AWSSDK.DynamoDBv2，然后选择安装。

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

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

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

有关更多信息，请参阅 AWS SDK for .NET。

注意

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

.NET：设置 AWS 凭证

适用于 .NET 的 SDK 要求在运行时向应用程序提供 AWS 凭证。本指南中的代码示例假定使用 SDK 存储来管理 AWS 凭证文件，如《适用于 .NET 的 AWS SDK 开发人员指南》的使用 SDK 存储所述。

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 用户指南》的指定凭证。

注意

代码示例默认访问美国西部（俄勒冈）区域的 DynamoDB。可以通过修改 App.config 文件的 AWSRegion 条目更改区域。可以将 AWSRegion 设置为 DynamoDB 可用的任何区域。有关完整列表，请参阅《Amazon Web Services 一般参考》中的 AWS 区域和终端节点。

.NET：设置 AWS 区域和端点

代码示例默认访问美国西部（俄勒冈）区域的 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 区域和终端节点。

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

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