诊断包简介

CommunityToolkit.Diagnostics 包包含用于有效验证方法参数并在错误代码路径中引发异常的 API。 它旨在用于帮助简化所有参数检查,并使其更具表达性和易读性,同时提高 codegen 质量和性能。

此包可以通过 NuGet 安装,并且包含以下多目标:

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

这意味着此包可用于任何可用的运行时(包括 .NET Framework、.NET Core、UWP、Unity、Xamarin、Uno、Blazor 等)。 在所有情况下,API 图面几乎完全相同,而当有较新的 API 可用时,可以优化内部实现。 整个诊断包是独立的,其范围和二进制大小非常小。

使用入门

若要在 Visual Studio 中安装包:

  1. 在“解决方案资源管理器”中,右键单击项目并选择“管理 NuGet 包”。 搜索“CommunityToolkit.Diagnostics”并安装它。

    NuGet Packages

  2. 添加 using 或 Import 指令以使用新 API:

    using CommunityToolkit.Diagnostics;
    
    Imports CommunityToolkit.Diagnostics
    

其他资源

可以在单元测试中查找更多示例。