.NET 代码示例 - Amazon DynamoDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

.NET 代码示例

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

可以使用 Amazon SDK for .NET 和 Toolkit for Visual Studio 快速入门。

运行 .NET 代码示例(使用 Visual Studio)

  1. 下载并安装 Microsoft Visual Studio

  2. 下载并安装 Toolkit for Visual Studio

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

  4. 新建项目中,选择Amazon 空项目,然后选择确定

  5. Amazon 访问凭证中,选择使用现有配置文件,从列表选择凭证配置文件,然后选择确定

    如果这是首次使用 Toolkit for Visual Studio,请选择使用新配置文件设置 Amazon 凭证。

  6. 在 Visual Studio 项目中,选择程序源代码 (Program.cs) 对应的选项卡。将文档页的代码示例复制到 Visual Studio 编辑器,并替换编辑器中的任何其他代码。

  7. 如果看到 The type or namespace name...could not be found 形式的错误消息,则需要为 DynamoDB 安装 Amazon SDK 程序集,如下所示:

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

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

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

    4. 选择 AWSSDK.DynamoDBv2,然后选择安装

    5. 安装完成后,选择 Program.cs 选项卡返回程序。

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

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

有关更多信息,请参阅 Amazon SDK for .NET

注意

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

.NET:设置 Amazon 凭证

Amazon SDK for .NET 要求在运行时向应用程序提供 Amazon 凭证。本指南中的代码示例假定使用 SDK Store 管理 Amazon 凭证文件,如 Amazon SDK for .NET 开发人员指南使用 SDK Store 所述。

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

下面的示例显示使用 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 组 Amazon 凭证。Amazon 凭证以加密形式保存在 SDK Store 中。Toolkit for Visual Studio 提供一个图形用户界面,用于在 Visual Studio 中管理凭证。有关更多信息,请参阅 Amazon Toolkit for Visual Studio 用户指南指定凭证

注意

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

.NET:设置 Amazon 区域和端点

代码示例默认访问美国西部(俄勒冈)区域的 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 一般参考Amazon 区域和端点

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

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