.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。依次选择 File (文件)New (新建)Project (项目)

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

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

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

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

  7. 如果您看到窗体的错误消息找不到类型或命名空间名称...,则需要安装Amazon用于 DynamoDB 的开发工具包程序集,如下所示

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

    2. 在 NuGet Package Manager 中,选择 Browse (浏览)

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

    4. 选择 AWSSDK.DynamoDBv2,然后选择 Install (安装)

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

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

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

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

注意

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

.NET: 设置Amazon凭证

这些区域有:Amazon SDK for .NET要求您提供Amazon凭证到运行时的应用程序。本指南中的代码示例假定您正在使用 SDK 存储来管理您的Amazon凭证文件,如中所述使用开发工具包存储中的Amazon SDK for .NET开发人员指南

Toolkit for Visual Studio 支持来自任意数量账户的多组凭证。每组凭证称为一个配置文件。视觉工作室将条目添加到项目的App.config文件,以便您的应用程序查找Amazon凭证。

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

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

在运行时,程序使用default设置Amazon凭证,如指定的AWSProfileName条目。这些区域有:Amazon凭证自身以加密形式保存在 SDK Store 中。Toolkit for Visual Studio 提供一个图形用户界面来管理您的来自 Visual Studio 的所有凭证。有关更多信息,请参阅 。指定凭证中的Amazon Toolkit for Visual Studio用户指南

注意

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

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

默认情况下,代码示例访问美国西部(俄勒冈)区域中的 DynamoDB。您可以通过修改 AWSRegion 文件中的 App.config 条目来更改区域。或者,您可以通过修改 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区域和终端节点中的Amazon Web Services 一般参考

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

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