O AWS SDK para .NET V3 entrou no modo de manutenção.

Recomendamos que você migre para a [AWS SDK para .NET V4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html). Para obter detalhes e informações adicionais sobre como migrar, consulte nosso [anúncio do modo de manutenção](https://aws.amazon.com/blogs/developer/aws-sdk-for-net-v3-maintenance-mode-announcement/).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# AWSAPIs assíncronas da para .NET
<a name="sdk-net-async-api"></a>

O AWS SDK para .NET usa o *Padrão Assíncrono Baseado em Tarefas (TAP)* para sua implementação assíncrona. Para saber mais sobre o TAP, consulte [Padrão assíncrono baseado em tarefas (TAP)](https://learn.microsoft.com/en-us/dotnet/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap) em docs.microsoft.com.

Este tópico fornece uma visão geral de como usar o TAP em suas chamadas para clientes do serviços da AWS.

Os métodos assíncronos na API do AWS SDK para .NET são operações baseadas na classe `Task` ou na classe `Task<TResult>`. Consulte docs.microsoft.com para obter informações sobre essas classes: [classe Task](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task), [classe Task<TResult>](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1).

Quando esses métodos de API são chamados em seu código, eles devem ser chamados em uma função declarada com a palavra-chave `async`, conforme mostrado no exemplo a seguir.

```
static async Task Main(string[] args)
{
  ...
  // Call the function that contains the asynchronous API method.
  // Could also call the asynchronous API method directly from Main
  //  because Main is declared async
  var response = await ListBucketsAsync();
  Console.WriteLine($"Number of buckets: {response.Buckets.Count}");
  ...
}

// Async method to get a list of Amazon S3 buckets.
private static async Task<ListBucketsResponse> ListBucketsAsync()
{
  ...
  var response = await s3Client.ListBucketsAsync();
  return response;
}
```

Conforme mostrado no trecho de código anterior, o escopo preferencial para a declaração `async` é a função `Main`. Definir esse escopo `async` garante que todas as chamadas para clientes de serviço da AWS sejam obrigatoriamente assíncronas. Se não puder declarar que `Main` seja assíncrono por algum motivo, você poderá usar a palavra-chave `async` em outras funções de `Main` e, em seguida, chamar os métodos da API a partir daí, conforme mostrado no exemplo a seguir. 

```
static void Main(string[] args)
{
  ...
  Task<ListBucketsResponse> response = ListBucketsAsync();
  Console.WriteLine($"Number of buckets: {response.Result.Buckets.Count}");
  ...
}

// Async method to get a list of Amazon S3 buckets.
private static async Task<ListBucketsResponse> ListBucketsAsync()
{
  ...
  var response = await s3Client.ListBucketsAsync();
  return response;
}
```

Observe a sintaxe especial `Task<>` que é necessária em `Main` quando você usa esse padrão. Além disso, você deve usar o membro **`Result`** da resposta para obter os dados.

Você pode ver exemplos completos de chamadas assíncronas para clientes AWS de serviço na seção [Faça um tour rápido](quick-start.md) ([Aplicativo simples para várias plataformas](quick-start-s3-1-cross.md)e[Aplicativo simples baseado no Windows](quick-start-s3-1-winvs.md)) e em [Exemplos de código com orientaçãoBibliotecas e estruturas de alto nível](tutorials-examples.md).