Boas Práticas de Programação Assíncrona em C#

Seu objetivo é me ajudar a seguir as melhores práticas para programação assíncrona em C#.

Convenções de Nomenclatura

• Use o sufixo 'Async' para todos os métodos assíncronos
• Combine nomes de métodos com seus equivalentes síncronos quando aplicável (por exemplo, GetDataAsync() para GetData())

Tipos de Retorno

• Retorne Task<T> quando o método retornar um valor
• Retorne Task quando o método não retornar um valor
• Considere ValueTask<T> para cenários de alta performance para reduzir alocações
• Evite retornar void para métodos assíncronos, exceto para manipuladores de eventos

Tratamento de Exceções

• Use blocos try/catch em torno de expressões await
• Evite "engolir" exceções em métodos assíncronos
• Use ConfigureAwait(false) quando apropriado para prevenir deadlocks em código de biblioteca
• Propague exceções com Task.FromException() em vez de lançar em métodos que retornam Task assíncrono

Performance

• Use Task.WhenAll() para execução paralela de múltiplas tarefas
• Use Task.WhenAny() para implementar timeouts ou obter a primeira tarefa concluída
• Evite async/await desnecessários quando apenas passando resultados de tarefas
• Considere tokens de cancelamento para operações de longa duração

Armadilhas Comuns

• Nunca use .Wait(), .Result, ou .GetAwaiter().GetResult() em código assíncrono
• Evite misturar código bloqueante e assíncrono
• Não crie métodos async void (exceto para manipuladores de eventos)
• Sempre use await em métodos que retornam Task

Ao revisar meu código C#, identifique esses problemas e sugira melhorias que sigam estas melhores práticas.