View a markdown version of this page

Exemplos de código .NET - Amazon DynamoDB
.NET: configurar as suas credenciais da AWS.NET: configurar a região e o endpoint da AWS

Exemplos de código .NET

Este guia contém trechos de código .NET e programas prontos para serem executados. Você encontrará esses exemplos de código nas seguintes seções:

Você pode começar rapidamente usando o AWS SDK para .NET com o Toolkit for Visual Studio.

Como executar os exemplos de código .NET (usando o Visual Studio)

  1. Baixe e instale o Microsoft Visual Studio.

  2. (Opcional) Baixe e instale o Toolkit for Visual Studio.

  3. Configure suas credenciais AWS. Configure um perfil de credenciais em seu arquivo de credenciais compartilhadas da AWS (~/.aws/credentials). Para obter mais informações, consulte Configurar credenciais da AWS no Guia do desenvolvedor do AWS SDK para .NET.

  4. Inicie o Visual Studio. Escolha File (Arquivo), New (Novo), Project (Projeto).

  5. Busque por Console App, selecione o modelo C# que tem como alvo o.NET e escolha Avançar. Configure o nome e a localização do projeto e, em seguida, escolha Criar.

  6. Adicione o pacote do NuGet para o AWS SDK para DynamoDB ao projeto:

    1. No Solution Explorer, abra o menu de contexto (clique com o botão direito do mouse) do seu projeto e escolha Manage NuGet Packages (Gerenciar pacotes do NuGet).

    2. No Gerenciador de pacotes NuGet, escolha Browse (Procurar).

    3. Na caixa de pesquisa, digite AWSSDK.DynamoDBv2 e aguarde a conclusão da pesquisa.

    4. Escolha AWSSDK.DynamoDBv2 e Install (Instalar).

  7. Em seu projeto do Visual Studio, abra Program.cs. Substitua o conteúdo pelo exemplo de código da página de documentação que você deseja executar.

  8. Para executar o código, escolha Start (Iniciar) na barra de ferramentas do Visual Studio.

O SDK para .NET fornece clientes thread-safe para trabalhar com o DynamoDB. De acordo com as melhores práticas, seus aplicativos devem criar um único cliente e reutilizá-lo entre os threads.

Para obter mais informações, consulte AWS SDK for .NET.

nota

Os exemplos de código neste guia são destinados para uso com a versão mais recente do AWS SDK para .NET.

.NET: configurar as suas credenciais da AWS

O SDK para .NET exige que você forneça credenciais da AWS para a sua aplicação em tempo de execução. Os exemplos de código neste guia pressupõem que você esteja usando o SDK Store para gerenciar seu arquivo de credenciais da AWS, conforme descrito em Usar o SDK Store no Guia do desenvolvedor do AWS SDK para .NET.

O Toolkit for Visual Studio oferece suporte a vários conjuntos de credenciais de qualquer número de contas. Cada conjunto é chamado de perfil. O Visual Studio adiciona entradas ao arquivo App.config do projeto para que a sua aplicação possa encontrar as credenciais da AWS em tempo de execução.

O exemplo a seguir mostra o arquivo App.config padrão que é gerado ao criar um novo projeto usando o 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>

Em tempo de execução, o programa usa o conjunto default de credenciais da AWS, conforme especificado pela entrada AWSProfileName. As credenciais da AWS são mantidas no SDK Store em formato criptografado. O Toolkit for Visual Studio fornece uma interface gráfica do usuário para gerenciar suas credenciais no Visual Studio. Para obter mais informações, consulte Specifying credentials (Especificar credenciais) no AWS Toolkit for Visual Studio User Guide (Guia do usuário do ).

nota

Por padrão, os exemplos de código acessam o DynamoDB na região Oeste dos EUA (Oregon). É possível alterar a região ao modificar a entrada AWSRegion no arquivo App.config. É possível definir AWSRegion como qualquer região em que o DynamoDB está disponível. Para obter uma lista completa, consulte Regiões e endpoints da AWS, na Referência geral da Amazon Web Services.

.NET: configurar a região e o endpoint da AWS

Por padrão, os exemplos de código acessam o DynamoDB na região Oeste dos EUA (Oregon). É possível alterar a região ao modificar a entrada AWSRegion no arquivo App.config. É possível alterar a região ao modificar as propriedades AmazonDynamoDBClient.

O exemplo de código a seguir instancia uma nova AmazonDynamoDBClient. O cliente é modificado de forma que o código seja executado no DynamoDB em uma região diferente.

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

Para obter uma lista completa de regiões, consulte Regiões e endpoints da AWS na Referência geral da Amazon Web Services.

Se desejar executar os exemplos de código usando o DynamoDB localmente no seu computador, defina o endpoint conforme descrito a seguir.

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