MemberNotNullAttribute 是 .NET 5 的新增特性,位于System.Diagnostics.CodeAnalysis。该特性用于显式声明,调用此方法后该值再也不为 Null。
示例以下,建立一个 csproj,启用 C# 8.0 的空引用类型新特性。api
<Project Sdk="Microsoft.NET.Sdk.Web"> <PropertyGroup> <TargetFramework>net5.0</TargetFramework> <Nullable>enable</Nullable> <WarningsAsErrors>$(WarningsAsErrors);CS8600;CS8602;CS8603;CS8618;CS8625</WarningsAsErrors> </PropertyGroup> </Project>
以下图所示,因为编译器没法保证 _mayNullStr.Length 不会引起空引用异常,因此抛出编译错误 CS8602;spa
此时能够经过添加 MemberNotNull 特性,显式地告诉编译器方法 PromisStrNotNull() 能够保证 _mayNullStr 不为 Null。code
此外他还有一个姊妹 MemberNotNullWhenAttributeblog
/// <summary> /// 返回 true 时,<see cref="_mayNullStr"/> 不为 null /// </summary> /// <returns></returns> [MemberNotNullWhen(true, nameof(_mayNullStr))] private bool StrNotNullWhenReturnTrue() { if (DateTime.Now.DayOfWeek == DayOfWeek.Friday) { _mayNullStr = "明天不用上班啦!"; return true; } _mayNullStr = null; return false; }