Introdução ao pacote diagnóstico

O 📦 pacote CommunityToolkit.Diagnostics contém APIs para validar com eficiência parâmetros de método e gerar exceções em caminhos de código com falha. Ele deve ser usado para ajudar a simplificar todas as verificações de argumento e torná-las mais expressivas e fáceis de ler e, ao mesmo tempo, melhorar a qualidade e o desempenho do codegen.

Esse pacote pode ser instalado por meio do NuGet e tem os seguintes multitargets:

• .NET Standard 2.0
• .NET 8

Isso 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 as APIs mais recentes estão disponíveis. O pacote de Diagnósticos como um todo deve ser independente e extremamente pequeno em escopo e em tamanho binário.

Introdução

Para instalar o pacote de dentro do Visual Studio:

1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Gerenciar Pacotes NuGet. Pesquise CommunityToolkit.Diagnostics e instale-o.

   

2. Adicione uma diretiva Using ou Imports para usar as novas APIs:

   using CommunityToolkit.Diagnostics;
   

   Imports CommunityToolkit.Diagnostics
   

Recursos adicionais

Você pode encontrar mais exemplos nos testes de unidade.