本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
本指南包含 .NET 程式碼片段和 ready-to-run程式。您可以在以下章節中找到這些程式碼範例:
您可以使用 Toolkit for Visual Studio AWS SDK for .NET 搭配 快速入門。
執行 .NET 程式碼範例 (使用 Visual Studio)
-
下載並安裝 Microsoft Visual Studio
。 -
下載並安裝 Toolkit for Visual Studio
。 -
啟動 Visual Studio。選擇 File (檔案)、New (新增)、Project (專案)。
-
在 New Project (新專案) 中,選擇 AWS Empty Project (AWS 空白專案),然後選擇 OK (確定)。
-
在 AWS Access Credentials (AWS 存取登入資料) 中,選擇 Use existing profile (使用現有的描述檔),然後從清單中選擇您的登入資料描述檔,再選擇 OK (確定)。
如果這是您第一次使用 Toolkit for Visual Studio,請選擇使用新的設定檔來設定您的 AWS 登入資料。
-
在您的 Visual Studio 專案中,選擇您程式之來源碼 (
Program.cs
) 的標籤。將程式碼範例從文件頁面複製到 Visual Studio 編輯器,以取代您在編輯器中所看到的任何其他程式碼。 -
如果您看到格式
的錯誤訊息 類型或命名空間名稱...找不到
,則需要安裝 AWS SDK DynamoDB 的組件,如下所示:-
在 Solution Explorer 中,開啟專案的內容 (按一下滑鼠右鍵) 選單,然後選擇管理 NuGet套件。
-
在 NuGet 套件管理員中,選擇瀏覽。
-
在搜尋方塊中輸入
AWSSDK.DynamoDBv2
,並等候搜尋完成。 -
選擇 AWSSDK.DynamoDBv2,然後選擇安裝。
-
安裝完成時,選擇 Program.cs 標籤返回您的程式。
-
-
若要執行程式碼,請在 Visual Studio 工具列中選擇 Start (啟動)。
AWS SDK for .NET 提供執行緒安全的用戶端,以使用 DynamoDB。根據最佳實務,您的應用程式應該建立一個用戶端,並在執行緒之間重複使用該用戶端。
如需詳細資訊,請參閱 AWS SDK for 。NET
注意
此指南中的程式碼範例適用於最新版的 AWS SDK for .NET。
.NET:設定您的 AWS 登入資料
AWS SDK for .NET 需要您在執行時間提供 AWS 登入資料給應用程式。本指南中的程式碼範例假設您使用 SDK 存放區來管理 AWS 登入資料檔案,如 AWS SDK for .NET 開發人員指南中的使用存放SDK區中所述。
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 使用者指南》中的指定登入資料。
注意
依預設,程式碼範例會存取美國西部 (奧勒岡) 區域的 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);