Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

Nullable referentni tipovi i kontekst #nullable

Oznake string i string? izražavaju namjeru u vezi s vrijednošću null, a analiza toka u prevoditelju upozorava na nesigurnu upotrebu. Kontekst #nullable zasebno upravlja oznakama i upozorenjima; ne dodaje provjere tijekom izvođenja.

Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaksa

T value;
T? optional;
#nullable enable
#nullable disable
#nullable restore
#nullable enable annotations
#nullable disable warnings
#nullable restore warnings

Nullable referentni tipovi uvedeni su u C# 8.0 i ne zahtijevaju preview način rada u projektu .NET 10. Kada su oznake uključene, string označava referencu koja prema namjeri ne bi trebala biti null, dok string? izričito dopušta null. Obje oznake odnose se na isti tip tijekom izvođenja; nisu ekvivalent za Nullable<T> koji se upotrebljava za vrijednosne tipove kao što je int?.

Prevoditelj razlikuje deklariranu oznaku vrijednosti od stanja koje u analizi toka pokazuje može li vrijednost biti null. Na ulazu u metodu prevoditelj na temelju oznaka obično pretpostavlja da parametar tipa string nije null, a da parametar tipa string? može biti null. To se stanje može promijeniti tijekom analize toka. Prevoditelj upozorava na dodjelu moguće vrijednosti null nenullabilnoj referenci i na dereferenciranje reference koja bi mogla biti null, primjerice putem text.Length. Nakon provjere text is null i izlaska iz te grane, analiza prepoznaje da je daljnja upotreba text sigurna. Operator text! samo mijenja procjenu prevoditelja: ne provjerava vrijednost i ne sprječava NullReferenceException.

Postavka projekta <Nullable>enable</Nullable> uključuje oznake i upozorenja. disable isključuje oboje, annotations uključuje samo oznake, a warnings samo upozorenja. Kada su oznake isključene, reference bez ? ne prate se u pogledu nullabilnosti, a upotreba ? može izazvati upozorenje.

Direktive #nullable enable i #nullable disable nadjačavaju postavke za sljedeće retke datoteke. #nullable restore vraća postavke projekta, a ne prethodnu direktivu. Neobavezni cilj annotations ili warnings, primjerice #nullable disable warnings, mijenja samo odgovarajuću zastavicu. Učinak traje do sljedeće primjenjive direktive ili do kraja datoteke.

Ovo je pomoć pri prevođenju, a ne jamstvo protiv null tijekom izvođenja. Primjerice, new string[3] u početku sadrži elemente null, unatoč tipu string[]. Ispravite tok podataka i provjeravajte vrijednosti umjesto da upozorenja naslijepo potiskujete s !.

Referentni identifikatori obuhvaćeni ovim unosom: Nullable reference annotations and #nullable context.

Primjeri

#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

Rezultat

missing
3

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori