Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

Nullable referenčné typy a kontext #nullable

Anotácie string a string? vyjadrujú zámer týkajúci sa hodnoty null, zatiaľ čo analýza toku v kompilátore upozorňuje na nebezpečné použitie. Kontext #nullable riadi anotácie a upozornenia nezávisle; nepridáva kontroly za behu.

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

Syntax

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

Nullable referenčné typy boli zavedené v C# 8.0 a v projekte .NET 10 nevyžadujú režim preview. Pri zapnutých anotáciách označuje string referenciu, ktorá podľa zámeru nemá byť null, zatiaľ čo string? hodnotu null výslovne povoľuje. Obe anotácie sa vzťahujú na rovnaký typ za behu; nejde o ekvivalent Nullable<T> pre hodnotové typy, ako je int?.

Kompilátor rozlišuje medzi deklarovanou anotáciou hodnoty a stavom nulovateľnosti, ktorý sleduje pri analýze toku. Pri vstupe do metódy kompilátor na základe anotácií zvyčajne predpokladá, že parameter typu string nie je null, kým parameter typu string? môže byť null. Tento stav sa môže v priebehu analýzy toku meniť. Kompilátor upozorní na priradenie možnej hodnoty null do nenullovateľnej referencie aj na dereferencovanie potenciálne nulovej referencie, napríklad pomocou text.Length. Po kontrole text is null a opustení tejto vetvy analýza rozpozná, že ďalšie použitie text je bezpečné. Operátor text! iba mení posúdenie kompilátora: hodnotu nekontroluje a nezabraňuje NullReferenceException.

Nastavenie projektu <Nullable>enable</Nullable> zapína anotácie aj upozornenia. disable vypína oboje, annotations zapína iba anotácie a warnings iba upozornenia. Pri vypnutých anotáciách sa pri referenciách bez ? nesleduje nulovateľnosť a použitie ? môže vyvolať upozornenie.

Direktívy #nullable enable a #nullable disable prepisujú nastavenia pre nasledujúce riadky súboru. #nullable restore obnoví nastavenia projektu, nie predchádzajúcu direktívu. Voliteľný cieľ annotations alebo warnings, napríklad #nullable disable warnings, mení iba príslušný príznak. Účinok trvá do ďalšej použiteľnej direktívy alebo do konca súboru.

Ide o pomoc pri kompilácii, nie o záruku proti null za behu. Napríklad new string[3] spočiatku obsahuje prvky null, hoci má typ string[]. Opravte tok údajov a hodnoty kontrolujte, namiesto toho, aby ste upozornenia bez rozmyslu potláčali pomocou !.

Referenčné identifikátory zahrnuté v tomto hesle: Nullable reference annotations and #nullable context.

Príklady

#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

Výsledok

missing
3

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje