Exemplos de código .NET - Amazon DynamoDB

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 for .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. Baixe e instale o Toolkit for Visual Studio.

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

  4. Em New Project (Novo projeto), escolha AWS Empty Project (Projeto vazio da ) e depois OK.

  5. Em Credenciais de acesso da AWS, escolha Usar perfil existente, escolha seu perfil de credenciais na lista e depois OK.

    Se esta for a primeira vez que você usa o Toolkit for Visual Studio, escolha Use a new profile (Usar um novo perfil) para configurar suas credenciais da AWS.

  6. No projeto do Visual Studio, escolha a guia para o código-fonte do seu programa (Program.cs). Copie o exemplo de código da página da documentação no editor do Visual Studio, substituindo qualquer outro código que você visualize no editor.

  7. Se você receber mensagens de erro da forma The type or namespace name...could not be found (O tipo ou nome do namespace...não pôde ser encontrado), será necessário instalar o conjunto do AWS SDK para o DynamoDB da seguinte forma:

    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).

    5. Quando a instalação estiver concluída, escolha a guia Program.cs para retornar ao seu programa.

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

O AWS SDK for .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 for .NET.

.NET: configurar as suas credenciais da AWS

O AWS SDK for .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 for .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);