.NET 程式碼範例

此指南包含 .NET 程式碼片段與可立即執行的程式。您可以在以下章節中找到這些程式碼範例：

• 使用項目和屬性

• 在 DynamoDB 中使用資料表和資料

• DynamoDB 中的查詢操作

• 在 DynamoDB 中使用掃描

• 使用次要索引來改善資料存取

• .NET：文件模型

• .NET：物件持久性模型

• DynamoDB Streams 的變更資料擷取

您可以將 AWS 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. 在 New Project (新專案) 中，選擇 AWS Empty Project (AWS 空白專案)，然後選擇 OK (確定)。

5. 在 AWS Access Credentials (AWS 存取登入資料) 中，選擇 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 (管理 NuGet 套件)。

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

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

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

   5. 安裝完成時，選擇 Program.cs 標籤返回您的程式。

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

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

如需詳細資訊，請參閱適用於 .NET 的 AWS 開發套件。

注意

此指南中的程式碼範例適用於最新版的 AWS SDK for .NET。

.NET：設定您的 AWS 登入資料

AWS SDK for .NET 需要您在執行時間將 AWS 登入資料提供給您的應用程式。本指南中的程式碼範例假設您正在使用開發套件存放區管理您的 AWS 登入資料檔案，如《AWS SDK for .NET 開發人員指南》中使用開發套件存放區所述。

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>

在執行時間，此程式會使用 AWS 登入資料的 default 集合，如 AWSProfileName 項目所指定。AWS 登入資料本身會以加密形式保留在開發套件存放區中。Toolkit for Visual Studio 提供圖形化使用者介面來管理所有來自於 Visual Studio 的登入資料。如需詳細資訊，請參閱《AWS Toolkit for Visual Studio 使用者指南》中的指定登入資料。

注意

依預設，程式碼範例會存取美國西部 (奧勒岡) 區域的 DynamoDB。您可以修改 App.config 檔案中的 AWSRegion 項目來變更區域。您可以將 AWSRegion 設定為 DynamoDB 可用的任何區域。如需完整清單，請參閱 Amazon Web Services 一般參考 中的 AWS 區域與端點。

.NET：設定 AWS 區域與端點

依預設，程式碼範例會存取美國西部 (奧勒岡) 區域的 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 Web Services 一般參考 中的 AWS 區域與端點。

如果您想要使用 DynamoDB 在電腦本機執行程式碼範例，請設定端點如下：

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