Ú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. Účelem je zjednodušit všechny kontroly argumentů, učinit je výstižnějšími a snadněji čitelnými, a současně zlepšit kvalitu a výkon generování kódu.

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

  • .NET Standard 2.0
  • .NET 8

To znamená, že balíček lze použít v jakémkoli dostupném modulu runtime (včetně .NET Framework, .NET, UPW, Unity, Xamarin, Uno a Blazor). 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íku řešení klikněte pravým tlačítkem na projekt a vyberte Spravovat balíčky NuGet. Vyhledejte CommunityToolkit.Diagnostics a nainstalujte ho.

    Balíčky NuGet

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

    using CommunityToolkit.Diagnostics;
    
    Imports CommunityToolkit.Diagnostics
    

Dodatečné zdroje

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