Introduzione al pacchetto di diagnostica

Il CommunityToolkit.Diagnostics pacchetto contiene API per convalidare in modo efficiente i parametri del metodo e generare eccezioni nei percorsi del codice con errori. È progettato per essere usato per semplificare tutti i controlli degli argomenti e per renderli più espressivi e più facili da leggere, migliorando allo stesso tempo la qualità e le prestazioni del codegen.

Questo pacchetto può essere installato tramite NuGet e ha le destinazioni seguenti:

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

Ciò significa che il pacchetto può essere usato in qualsiasi runtime disponibile (tra cui .NET Framework, .NET Core, UWP, Unity, Xamarin, Uno, Blazor e così via). La superficie DELL'API è quasi identica in tutti i casi, mentre l'implementazione interna può essere ottimizzata quando sono disponibili API più recenti. Il pacchetto diagnostics nel suo complesso è progettato per essere autonomo e estremamente piccolo in ambito e dimensioni binarie.

Introduzione

Per installare il pacchetto da Visual Studio:

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e scegliere Gestisci pacchetti NuGet. Cercare CommunityToolkit.Diagnostics e installarlo.

    NuGet Packages

  2. Aggiungere una direttiva using o Imports per usare le nuove API:

    using CommunityToolkit.Diagnostics;
    
    Imports CommunityToolkit.Diagnostics
    

Risorse aggiuntive

Altri esempi sono disponibili negli unit test.