诊断包简介
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 中安装包:
在“解决方案资源管理器”中,右键单击项目并选择“管理 NuGet 包”。 搜索“CommunityToolkit.Diagnostics”并安装它。
添加 using 或 Import 指令以使用新 API:
using CommunityToolkit.Diagnostics;
Imports CommunityToolkit.Diagnostics
其他资源
可以在单元测试中查找更多示例。