Úvod do diagnostického balíčku

Balíček CommunityToolkit.Diagnostics obsahuje rozhraní API pro efektivní ověření parametrů metody a vyvolání výjimek v chybných cestách kódu. Je určena k zjednodušení všech kontrol argumentů a k tomu, aby byly výraznější a snadněji čitelné, a zároveň zlepšily kvalitu a výkon codegenu.

Tento balíček je možné nainstalovat prostřednictvím NuGetu a má následující cíle:

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

To znamená, že balíček lze použít v jakémkoli dostupném modulu runtime (včetně .NET Framework, .NET Core, UPW, Unity, Xamarin, Uno, Blazor atd.). Povrch rozhraní API je téměř stejný ve všech případech, zatímco interní implementaci je možné optimalizovat, když jsou k dispozici novější rozhraní API. Balíček Diagnostika jako celek je určen jako samostatný a extrémně malý v rozsahu a binární velikosti.

Začínáme

Instalace balíčku ze sady Visual Studio:

  1. V Průzkumník řešení klikněte pravým tlačítkem na projekt a vyberte Spravovat balíčky NuGet. Vyhledejte CommunityToolkit.Diagnostics a nainstalujte ho.

    NuGet Packages

  2. Přidejte direktivu using nebo Imports pro použití nových rozhraní API:

    using CommunityToolkit.Diagnostics;
    
    Imports CommunityToolkit.Diagnostics
    

Další materiály

Další příklady najdete v testech jednotek.