Programmazione asincrona utilizzando AWS SDK per .NET

The AWS SDK per .NET utilizza l'Task-based Asynchronous Pattern (TAP) per la sua implementazione asincrona. Per ulteriori informazioni sul TAP, vedere Task-based Asynchronous Pattern (TAP) su docs.microsoft.com.

Questo argomento offre una panoramica di come utilizzare TAP nelle chiamate ai clienti del servizio. AWS

I metodi asincroni dell' AWS SDK per .NET API sono operazioni basate sulla Task classe o sulla classe. Task<TResult> <TResult>Per informazioni su queste classi, consultate docs.microsoft.com: classe Task, classe Task. https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1

Quando questi metodi API vengono richiamati nel codice, devono essere richiamati all'interno di una funzione dichiarata con la async parola chiave, come mostrato nell'esempio seguente.

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;
}

Come mostrato nel frammento di codice precedente, l'ambito preferito per la async dichiarazione è la funzione. Main L'impostazione di questo async ambito garantisce che tutte le chiamate ai client di AWS servizio debbano essere asincrone. Se per qualche motivo non puoi Main dichiarare di essere asincrono, puoi utilizzare la async parola chiave su funzioni diverse da Main e quindi chiamare i metodi API da lì, come mostrato nell'esempio seguente.

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;
}

Nota la Task<> sintassi speciale necessaria Main quando usi questo modello. Inoltre, è necessario utilizzare il Result membro della risposta per ottenere i dati.

Puoi vedere esempi completi di chiamate asincrone ai client di AWS servizio nelle Creazione di un'applicazione semplice sezioni (Semplice app multipiattaformae) e Semplice app basata su Windows in. Esempi di codice guidati