База знанияИзпитен център
BGБългарски
Избери език13

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 warnings

Nullable референтните типове са въведени в 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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници