Partager via


Présentation du package Diagnostics

Le package CommunityToolkit.Diagnostics contient des API permettant de valider efficacement des paramètres de méthode et de lever des exceptions dans les chemins de code défaillants. Il est destiné à être utilisé pour simplifier toutes les vérifications d’arguments, ainsi que pour les rendre plus expressifs et faciles à lire, tout en améliorant la qualité et les performances de la codegen.

Ce package peut être installé via NuGet. Il dispose des cibles multiples suivantes :

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

Cela signifie que le package peut être utilisé sur n’importe quel runtime disponible (y compris .NET Framework, .NET Core, UWP, Unity, Xamarin, Uno, Blazor, etc.). La surface d’API est presque identique dans tous les cas et l’implémentation interne peut être optimisée lorsque des API plus récentes sont disponibles. L’ensemble du package Diagnostics est censé être autonome et extrêmement petit en matière d’étendue et de taille binaire.

Mise en route

Pour installer le package à partir de Visual Studio :

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis sélectionnez Gérer les packages NuGet. Recherchez CommunityToolkit.Diagnostics et installez-le.

    NuGet Packages

  2. Ajoutez une directive Imports ou d’utilisation afin d’utiliser les nouvelles API :

    using CommunityToolkit.Diagnostics;
    
    Imports CommunityToolkit.Diagnostics
    

Ressources supplémentaires

D’autres exemples se trouvent dans les tests unitaires.