Introdução ao Pacote de Diagnóstico

  • Artigo

O pacote CommunityToolkit.Diagnostics contém APIs para validar com eficiência os parâmetros do 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 vários destinos a seguir:

  • .NET Standard 2.0
  • .NET Standard 2.1
  • .NET 6

Isso significa que o pacote pode ser usado em qualquer runtime disponível (incluindo .NET Framework, .NET Core, UWP, Unity, Xamarin, Uno, Blazor etc.). 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óstico como um todo deve ser autocontido e extremamente pequeno no escopo e no 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.

    NuGet Packages

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

    using CommunityToolkit.Diagnostics;

    Imports CommunityToolkit.Diagnostics

Recursos adicionais

Encontre mais exemplos nos testes de unidade.