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

CKTIS / C#

`#nullable enable` a anotace `T?` pro referenční typy

Zapněte anotace referenčních typů a upozornění kompilátoru. Zjistěte, jak kontrola hodnoty `null` ovlivňuje analýzu toku a proč `string?` nefunguje stejně jako `int?`.

Verze: C# 12 and .NET 8; later runtimes may add compatible features

Syntaxe

#nullable enable
// T? denotes a nullable reference when T is a reference type.
static void ShowLength(string? text)
{
    if (text is not null)
        System.Console.WriteLine(text.Length);
}
#nullable restore

#nullable enable zapíná anotace pro práci s hodnotou null i související upozornění. Direktiva platí od daného místa ve zdrojovém souboru až do konce souboru nebo dokud toto nastavení nezmění jiná direktiva. #nullable restore obnoví nastavení projektu, nikoli předchozí nastavení v souboru.

Je-li T referenční typ, T? připouští null, zatímco T znamená, že se očekává reference jiná než null. string a string? jsou za běhu stejný typ a nelze jimi rozlišit přetížení. Kompilátor nevkládá automatickou kontrolu, takže přístup ke členu přes referenci s hodnotou null může stále vyvolat NullReferenceException.

Analýza toku sleduje, zda reference může na daném místě obsahovat null. Přístup k text.Length před kontrolou by vyvolal upozornění CS8602. Díky podmínce text is null a předčasnému return se k pozdějšímu přístupu dojde, jen když text není null. Zápis text! může upozornění potlačit, ale hodnotu nekontroluje ani nemění.

Naproti tomu int? je zkratka pro System.Nullable<int>, samostatný hodnotový typ, který může vyjádřit i nepřítomnost hodnoty. string? neobaluje referenci do typu System.Nullable<T>.

Příklady

#nullable enable
using System;

PrintLength(null);
PrintLength("Ada");

static void PrintLength(string? text)
{
    // Console.WriteLine(text.Length); // CS8602
    if (text is null)
    {
        Console.WriteLine("No text");
        return;
    }

    Console.WriteLine(text.Length);
}

Výsledek

No text
3

První volání vypíše `No text` a skončí před čtením `Length`. Druhé vypíše `3`. Chcete-li zobrazit `CS8602`, odkomentujte první přístup k `text.Length` v metodě `PrintLength` a program sestavte bez spuštění.

Související lekce

  • C# · Lekce 17 · Středně pokročilá · Verze: 2

Zdroje