Einführung in das Diagnosepaket

Das 📦 CommunityToolkit.Diagnostics-Paket enthält APIs zum effizienten Überprüfen von Methodenparametern und zum Auslösen von Ausnahmen in fehlerhaften Codepfaden. Es soll verwendet werden, um alle Argumentprüfungen zu vereinfachen und sie ausdrucksstärker und leichter lesbar zu machen, während gleichzeitig die Qualität und Leistung der Codegenerierung verbessert werden.

Dieses Paket kann über NuGet installiert werden und hat die folgenden Multitargets:

• .NET-Standard 2.0
• .NET 8

Dies bedeutet, dass das Paket für jede verfügbare Laufzeit verwendet werden kann (einschließlich .NET Framework, .NET, UWP, Unity, Xamarin, Uno und Blazor). Die API-Oberfläche ist in allen Fällen fast identisch, während die interne Implementierung optimiert werden kann, wenn neuere APIs verfügbar sind. Das Diagnosepaket als Ganzes soll eigenständig und extrem klein in Bereich und Binärgröße sein.

Erste Schritte

So installieren Sie das Paket aus Visual Studio:

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie "NuGet-Pakete verwalten" aus. Suchen Sie nach CommunityToolkit.Diagnostics , und installieren Sie es.

   

2. Fügen Sie eine Using- oder Imports-Direktive hinzu, um die neuen APIs zu verwenden:

   using CommunityToolkit.Diagnostics;
   

   Imports CommunityToolkit.Diagnostics
   

Weitere Ressourcen

Weitere Beispiele finden Sie in den Komponententests.