.NET code examples - Amazon DynamoDB
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

.NET code examples

This guide contains .NET code snippets and ready-to-run programs. You can find these code examples in the following sections:

You can get started quickly by using the Amazon SDK for .NET with the Toolkit for Visual Studio.

To run the .NET code examples (using Visual Studio)
  1. Download and install Microsoft Visual Studio.

  2. Download and install the Toolkit for Visual Studio.

  3. Start Visual Studio. Choose File, New, Project.

  4. In New Project, choose Amazon Empty Project, and then choose OK.

  5. In Amazon Access Credentials, choose Use existing profile, choose your credentials profile from the list, and then choose OK.

    If this is your first time using Toolkit for Visual Studio, choose Use a new profile to set up your Amazon credentials.

  6. In your Visual Studio project, choose the tab for your program's source code (Program.cs). Copy the code example from the documentation page into the Visual Studio editor, replacing any other code that you see in the editor.

  7. If you see error messages of the form The type or namespace name...could not be found, you need to install the Amazon SDK assembly for DynamoDB as follows:

    1. In Solution Explorer, open the context (right-click) menu for your project, and then choose Manage NuGet Packages.

    2. In NuGet Package Manager, choose Browse.

    3. In the search box, enter AWSSDK.DynamoDBv2, and wait for the search to complete.

    4. Choose AWSSDK.DynamoDBv2, and then choose Install.

    5. When the installation is complete, choose the Program.cs tab to return to your program.

  8. To run the code, choose Start in the Visual Studio toolbar.

The Amazon SDK for .NET provides thread-safe clients for working with DynamoDB. As a best practice, your applications should create one client and reuse the client between threads.

For more information, see Amazon SDK for .NET.


The code examples in this guide are intended for use with the latest version of the Amazon SDK for .NET.

.NET: Setting your Amazon credentials

The Amazon SDK for .NET requires that you provide Amazon credentials to your application at runtime. The code examples in this guide assume that you are using the SDK Store to manage your Amazon credentials file, as described in Using the SDK store in the Amazon SDK for .NET Developer Guide.

The Toolkit for Visual Studio supports multiple sets of credentials from any number of accounts. Each set is referred to as a profile. Visual Studio adds entries to the project's App.config file so that your application can find the Amazon credentials at runtime.

The following example shows the default App.config file that is generated when you create a new project using 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>

At runtime, the program uses the default set of Amazon credentials, as specified by the AWSProfileName entry. The Amazon credentials themselves are kept in the SDK Store in encrypted form. The Toolkit for Visual Studio provides a graphical user interface for managing your credentials, all from within Visual Studio. For more information, see Specifying credentials in the Amazon Toolkit for Visual Studio User Guide.


By default, the code examples access DynamoDB in the US West (Oregon) Region. You can change the Region by modifying the AWSRegion entry in the App.config file. You can set AWSRegion to any Region where DynamoDB is available. For a complete list, see Amazon regions and endpoints in the Amazon Web Services General Reference.

.NET: Setting the Amazon Region and endpoint

By default, the code examples access DynamoDB in the US West (Oregon) Region. You can change the Region by modifying the AWSRegion entry in the App.config file. Or, you can change the Region by modifying the AmazonDynamoDBClient properties.

The following code example instantiates a new AmazonDynamoDBClient. The client is modified so that the code runs against DynamoDB in a different Region.

AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig(); // This client will access the US East 1 region. clientConfig.RegionEndpoint = RegionEndpoint.USEast1; AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);

For a complete list of Regions, see Amazon regions and endpoints in the Amazon Web Services General Reference.

If you want to run the code examples using DynamoDB locally on your computer, set the endpoint as follows.

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