Amazon DynamoDB
开发人员指南 (API Version 2012-08-10)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

.NET 代码示例

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

您可以通过结合使用适用于 .NET 的 AWS 开发工具包和 Toolkit for Visual Studio 来实现快速入门。

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

  1. 下载并安装 Microsoft Visual Studio

  2. 下载并安装 Toolkit for Visual Studio

  3. 启动 Visual Studio,然后依次选择 FileNewProject

  4. New Project 中,选择 AWS Empty Project,然后选择 OK

  5. AWS Access Credentials 中,选择 Use existing profile,从列表中选择您的凭证配置文件,然后选择 OK

    如果这是您首次使用 Toolkit for Visual Studio,请选择 Use a new profile 以设置您的 AWS 凭证。

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

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

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

    2. 在 NuGet Package Manager 中,选择 Browse

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

    4. 选择 AWSSDK.DynamoDBv2,然后选择 Install

    5. 安装完成后,请选择 Program.cs 选项卡以返回到您的程序。

  8. 要运行代码,请在 Visual Studio 工具栏中选择 Start 按钮。

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

有关更多信息,请参阅适用于 .NET 的 AWS 开发工具包

注意

本开发人员指南中的代码示例旨在用于最新版本的适用于 .NET 的 AWS 开发工具包。

.NET:设置 AWS 凭证

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

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

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

Copy
<?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 设置为 Amazon DynamoDB 可用的任何 AWS 区域。有关完整列表,请参阅 Amazon Web Services 一般参考 中的 AWS 区域和终端节点

.NET:设置 AWS 区域和终端节点

默认情况下,代码示例访问 美国西部(俄勒冈) 区域中的 DynamoDB。您可以通过修改 App.config 文件中的 AWSRegion 条目来更改此区域。或者,您可以通过修改 AmazonDynamoDBClient 属性来更改区域。

下面的代码段用于实例化新的 AmazonDynamoDBClient。修改客户端,以便对其他区域中的 DynamoDB 运行该代码。

Copy
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 运行代码示例,您需要设置终端节点:

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