CKTIS / C#
Nullable референтни типове и контекстът #nullable
Анотациите string и string? изразяват намерението относно null, а анализът на потока в компилатора предупреждава за опасна употреба. Контекстът #nullable управлява анотациите и предупрежденията поотделно; не добавя проверки по време на изпълнение.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
T value;
T? optional;
#nullable enable
#nullable disable
#nullable restore
#nullable enable annotations
#nullable disable warnings
#nullable restore warningsNullable референтните типове са въведени в C# 8.0 и не изискват preview режим в проект за .NET 10. Когато анотациите са включени, string означава референция, която според намерението не трябва да бъде null, а string? изрично допуска null. И двете анотират един и същ тип по време на изпълнение; не са еквивалент на Nullable<T> за типове стойност като int?.
Компилаторът разграничава декларираната анотация на дадена стойност от състоянието, което проследява при анализа на потока: дали стойността може да е null. При влизане в метод компилаторът обикновено приема въз основа на анотациите, че параметър от тип string не е null, а параметър от тип string? може да е null. Това състояние може да се променя в хода на анализа на потока. Компилаторът предупреждава при присвояване на възможна стойност null към ненулева референция и при разименуване на референция, която може да е null, например чрез text.Length. След проверката text is null и излизането от този клон анализът разпознава, че последващата употреба на text е безопасна. Операторът text! променя само преценката на компилатора: не проверява стойността и не предотвратява NullReferenceException.
Настройката на проекта <Nullable>enable</Nullable> включва анотациите и предупрежденията. disable изключва и двете, annotations включва само анотациите, а warnings — само предупрежденията. При изключени анотации референциите без ? не се проследяват по отношение на null стойности, а употребата на ? може да предизвика предупреждение.
Директивите #nullable enable и #nullable disable заменят настройките за следващите редове във файла. #nullable restore възстановява настройките на проекта, а не предходната директива. Незадължителна цел annotations или warnings, например #nullable disable warnings, променя само съответния флаг. Ефектът продължава до друга приложима директива или до края на файла.
Това е помощ при компилация, а не гаранция срещу null по време на изпълнение. Например new string[3] първоначално съдържа елементи null, въпреки типа си string[]. Поправяйте потока на данните и проверявайте стойностите, вместо безразборно да потискате предупрежденията с !.
Референтни идентификатори, обхванати в тази статия: Nullable reference annotations and #nullable context.
Примери
#nullable enable
using System;
internal static class Program
{
private static void Main()
{
PrintLength(null);
PrintLength("Ada");
}
private static void PrintLength(string? text)
{
if (text is null)
{
Console.WriteLine("missing");
return;
}
Console.WriteLine(text.Length);
}
}
#nullable restoreРезултат
missing 3
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.