Udostępnij za pośrednictwem

Wprowadzenie do pakietu diagnostycznego

  • Artykuł

Pakiet CommunityToolkit.Diagnostics zawiera interfejsy API służące do wydajnego weryfikowania parametrów metody i zgłaszania wyjątków w błędnych ścieżkach kodu. Ma to pomóc uprościć wszystkie kontrole argumentów i uczynić je bardziej wyrazistymi i łatwiejszymi do odczytania, jednocześnie poprawiając jakość i wydajność kodu.

Ten pakiet można zainstalować za pomocą narzędzia NuGet i ma następujące obiekty wielowersyjne:

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

Oznacza to, że pakiet może być używany w dowolnym dostępnym środowisku uruchomieniowym (w tym .NET Framework, .NET Core, UWP, Unity, Xamarin, Uno, Blazor itp.). Powierzchnia interfejsu API jest prawie identyczna we wszystkich przypadkach, podczas gdy implementacja wewnętrzna może być zoptymalizowana, gdy są dostępne nowsze interfejsy API. Pakiet diagnostyczny jako całość ma być samodzielny i niezwykle mały w zakresie i rozmiarze binarnym.

Wprowadzenie

Aby zainstalować pakiet z poziomu programu Visual Studio:

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt i wybierz polecenie Zarządzaj pakietami NuGet. Wyszukaj ciąg CommunityToolkit.Diagnostics i zainstaluj go.

    NuGet Packages

  2. Dodaj dyrektywę using lub Import, aby użyć nowych interfejsów API:

    using CommunityToolkit.Diagnostics;

    Imports CommunityToolkit.Diagnostics

Dodatkowe zasoby

Więcej przykładów można znaleźć w testach jednostkowych.