# Exemplos de código .NET
<a name="CodeSamples.DotNet"></a>

**Topics**
+ [.NET: configurar as suas credenciais da AWS](#CodeSamples.DotNet.Credentials)
+ [.NET: configurar a região e o endpoint da AWS](#CodeSamples.DotNet.RegionAndEndpoint)

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:
+ [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md)
+ [Trabalhar com tabelas e dados no DynamoDB](WorkingWithTables.md)
+ [Consultar tabelas no DynamoDB](Query.md)
+ [Verificar tabelas no DynamoDB](Scan.md)
+ [Melhorar o acesso aos dados com índices secundários no DynamoDB](SecondaryIndexes.md)
+ [Trabalhar com o modelo de documento do .NET no DynamoDB](DotNetSDKMidLevel.md)
+ [Trabalhar com o modelo de persistência de objetos do .NET e o DynamoDB](DotNetSDKHighLevel.md)
+ [Capturar dados de alterações para o DynamoDB Streams](Streams.md)

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](https://www.visualstudio.com).

1. (Opcional) Baixe e instale o [Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/).

1. 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](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html) no *Guia do desenvolvedor do AWS SDK para .NET*.

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

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

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

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

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

   1. Escolha **AWSSDK.DynamoDBv2** e **Install (Instalar)**.

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

1. 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](https://aws.amazon.com/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
<a name="CodeSamples.DotNet.Credentials"></a>

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](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html#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](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/tkv_setup.html#creds) (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](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region), na *Referência geral da Amazon Web Services*.

## .NET: configurar a região e o endpoint da AWS
<a name="CodeSamples.DotNet.RegionAndEndpoint"></a>

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](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) 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);
```