本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# .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。選擇 **File (檔案)**、**New (新增)**、**Project (專案)**。

1. 搜尋**主控台應用程式**，選取以 .NET 為目標的 C\$1 範本，然後選擇**下一步**。設定您的專案名稱和位置，然後選擇**建立**。

1. 將適用於 DynamoDB NuGet 的 AWS SDK 套件新增至您的專案：

   1. 在方案總管中，開啟您專案的內容 (右鍵) 選單，然後選擇 **Manage NuGet Packages (管理 NuGet 套件)**。

   1. 在 NuGet 套件管理員中，選擇 **Browse (瀏覽)**。

   1. 在搜尋方塊中輸入 **AWSSDK.DynamoDBv2**，並等候搜尋完成。

   1. 選擇 **AWSSDK.DynamoDBv2**，然後選擇 **Install (安裝)**。

1. 在您的 Visual Studio 專案中，開啟 `Program.cs`。將內容取代為您要執行的文件頁面中的程式碼範例。

1. 若要執行程式碼，請在 Visual Studio 工具列中選擇 **Start (啟動)**。

 適用於 .NET 的 SDK 提供使用 DynamoDB 的安全執行緒用戶端。根據最佳實務，您的應用程式應該建立一個用戶端，並在執行緒之間重複使用該用戶端。

如需詳細資訊，請參閱[適用於 .NET 的AWS 軟體開發套件](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 登入資料。

下列範例顯示預設 `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>
```

在執行時間，程式會使用 `AWSProfileName` 項目指定的`default`一組 AWS 登入資料。 AWS 登入資料本身會以加密形式保存在 SDK 存放區中。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);
```