WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Nullable-Referenztypen und der #nullable-Kontext

Die Anmerkungen string und string? drücken die Absicht bezüglich null aus; die Flussanalyse des Compilers warnt vor unsicherer Verwendung. Der #nullable-Kontext steuert Anmerkungen und Warnungen unabhängig voneinander und fügt keine Laufzeitprüfungen hinzu.

Version: .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-Referenztypen wurden mit C# 8.0 eingeführt und erfordern in einem .NET-10-Projekt keinen Preview-Modus. Bei aktivierten Anmerkungen steht string für eine Referenz, die laut Absicht nicht null sein soll; string? lässt null ausdrücklich zu. Beide bezeichnen denselben Laufzeittyp und sind nicht mit Nullable<T> für Werttypen wie int? gleichzusetzen.

Der Compiler unterscheidet die deklarierte Anmerkung eines Werts von seinem Nullzustand in der Flussanalyse. Zu Beginn einer Methode geht der Compiler anhand der Anmerkungen in der Regel davon aus, dass ein Parameter vom Typ string nicht null ist und ein Parameter vom Typ string? null sein kann. Der Zustand kann sich im Verlauf der Flussanalyse ändern. Der Compiler warnt, wenn ein möglicherweise null-Wert einer nicht-nullbaren Referenz zugewiesen oder eine möglicherweise nullbare Referenz dereferenziert wird, etwa durch text.Length. Nach der Prüfung text is null und dem Verlassen dieses Zweigs erkennt die Analyse, dass die anschließende Verwendung von text sicher ist. Der Operator text! ändert nur die Einschätzung des Compilers: Er prüft den Wert nicht und verhindert keine NullReferenceException.

Die Projekteinstellung <Nullable>enable</Nullable> aktiviert Anmerkungen und Warnungen. disable schaltet beide aus, annotations aktiviert nur Anmerkungen und warnings nur Warnungen. Bei deaktivierten Anmerkungen gelten Referenzen ohne ? als nicht auf Nullbarkeit geprüft; die Verwendung von ? kann dann eine Warnung auslösen.

Die Direktiven #nullable enable und #nullable disable setzen die Einstellungen für die folgenden Zeilen der Datei außer Kraft. #nullable restore stellt die Projekteinstellungen wieder her, nicht die vorherige Direktive. Ein optionales Ziel annotations oder warnings, etwa #nullable disable warnings, ändert nur das jeweilige Flag. Die Wirkung gilt bis zu einer weiteren passenden Direktive oder bis zum Dateiende.

Dies ist Unterstützung zur Kompilierzeit und keine Garantie gegen null zur Laufzeit. Zum Beispiel enthält new string[3] anfangs null-Elemente, obwohl der Typ string[] lautet. Korrigiere den Datenfluss und prüfe Werte, statt Warnungen blind mit ! zu unterdrücken.

In diesem Eintrag behandelte Referenzbezeichner: Nullable reference annotations and #nullable context.

Beispiele

#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

Ergebnis

missing
3

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen