Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Nullable referenční typy a kontext #nullable

Anotace string a string? vyjadřují záměr ohledně hodnoty null, zatímco analýza toku v kompilátoru upozorňuje na nebezpečné použití. Kontext #nullable řídí anotace a upozornění nezávisle; nepřidává kontroly za běhu.

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

Syntaxe

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

Nullable referenční typy byly zavedeny v C# 8.0 a v projektu .NET 10 nevyžadují režim preview. Při zapnutých anotacích označuje string referenci, která podle záměru nemá být null, zatímco string? hodnotu null výslovně povoluje. Obě anotace se vztahují ke stejnému typu za běhu; nejde o ekvivalent Nullable<T> pro hodnotové typy, jako je int?.

Kompilátor rozlišuje mezi deklarovanou anotací hodnoty a stavem nulovatelnosti, který sleduje při analýze toku. Při vstupu do metody kompilátor na základě anotací obvykle předpokládá, že parametr typu string není null, zatímco parametr typu string? může být null. Tento stav se může v průběhu analýzy toku měnit. Kompilátor upozorní na přiřazení možné hodnoty null do nenullovatelné reference i na dereferencování potenciálně nulové reference, například pomocí text.Length. Po kontrole text is null a opuštění této větve analýza rozpozná, že další použití text je bezpečné. Operátor text! pouze mění posouzení kompilátoru: hodnotu nekontroluje a nezabraňuje NullReferenceException.

Nastavení projektu <Nullable>enable</Nullable> zapíná anotace i upozornění. disable vypíná obojí, annotations zapíná pouze anotace a warnings pouze upozornění. Při vypnutých anotacích se u referencí bez ? nulovatelnost nesleduje a použití ? může vyvolat upozornění.

Direktivy #nullable enable a #nullable disable přepisují nastavení pro následující řádky souboru. #nullable restore obnoví nastavení projektu, nikoli předchozí direktivu. Volitelný cíl annotations nebo warnings, například #nullable disable warnings, mění pouze příslušný příznak. Účinek trvá do další použitelné direktivy nebo do konce souboru.

Jde o pomoc při kompilaci, nikoli o záruku proti null za běhu. Například new string[3] zpočátku obsahuje prvky null, přestože má typ string[]. Opravte tok dat a hodnoty kontrolujte, místo abyste upozornění bez rozmyslu potlačovali pomocí !.

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

Pří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ýsledek

missing
3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje