Freigeben über

Einführung in das Diagnostics-Paket

  • Artikel

Das CommunityToolkit.Diagnostics-Paket enthält APIs zum effizienten Überprüfen von Methodenparametern und zum Auslösen von Ausnahmen in fehlerhaften Codepfaden. Es wird verwendet, um alle Argumentprüfungen zu vereinfachen sowie ausdrucksstärker und einfacher lesbar zu machen und um gleichzeitig die Qualität und Leistung von Codegen zu verbessern.

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

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

Dies bedeutet, dass das Paket für jede verfügbare Laufzeit verwendet werden kann (einschließlich .NET Framework, .NET Core, UWP, Unity, Xamarin, Uno, Blazor usw.). 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 Diagnostics-Paket als Ganzes soll eigenständig und extrem klein hinsichtlich Umfang 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.

    NuGet Packages

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

    using CommunityToolkit.Diagnostics;

    Imports CommunityToolkit.Diagnostics

Zusätzliche Ressourcen

Weitere Beispiele finden Sie in den Komponententests.