.NET コード例 - Amazon DynamoDB
.NET: AWS 認証情報の設定.NET: AWS リージョンとエンドポイントの設定

.NET コード例

このガイドには、.NET コードスニペットとすぐに使用できるプログラムが含まれています。これらのコード例は、次のセクションで確認することができます。

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. [新しいプロジェクト] で、[空の AWS プロジェクト]、[OK] の順に選択します。

  5. [AWS アクセス認証情報] で、[既存のプロファイルを使用] を選択し、リストから自分の認証情報の内容を選択して、[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 SDK アセンブリをインストールする必要があります。

    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 を操作するためにスレッドセーフなクライアントが用意されています。ベストプラクティスとして、ご利用のアプリケーションでクライアントを 1 つ作成し、そのクライアントをスレッド間で再利用します。

詳細については、「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 認証情報を見つけることができます。

次の例は、Toolkit for Visual Studio を使用した新しいプロジェクトの作成時に生成されたデフォルトの App.config ファイルを示しています。

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

ランタイム時に、このプログラムは AWSProfileName エントリで指定されているように、AWS 認証情報の default セットを使用します。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);