Introdução ao pacote Diagnostics

O 📦 pacote CommunityToolkit.Diagnostics contém APIs para validar eficientemente os parâmetros do método e lançar exceções em caminhos de código com falhas. Destina-se a ser usado para ajudar a simplificar todas as verificações de argumentos e torná-las mais expressivas e fáceis de ler, ao mesmo tempo que melhora a qualidade e o desempenho do codegen.

Este pacote pode ser instalado através do NuGet, e tem os seguintes multitargets:

• .NET Padrão 2.0
• .NET 8

Isto significa que o pacote pode ser usado em qualquer runtime disponível (incluindo .NET Framework, .NET, UWP, Unity, Xamarin, Uno e Blazor). A superfície da API é quase idêntica em todos os casos, enquanto a implementação interna pode ser otimizada quando há APIs mais recentes disponíveis. O pacote Diagnostics como um todo é pensado para ser autónomo e extremamente pequeno em âmbito e tamanho binário.

Introdução

Para instalar o pacote a partir do Visual Studio:

1. No Explorador de Soluções, clique com o botão direito no projeto e selecione Gerir Pacotes NuGet. Procure por CommunityToolkit.Diagnostics e instale-o.

   

2. Adicione uma diretiva using or Imports para usar as novas APIs:

   using CommunityToolkit.Diagnostics;
   

   Imports CommunityToolkit.Diagnostics
   

Recursos adicionais

Podes encontrar mais exemplos nos testes unitários.