WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

`#nullable enable` und die `T?`-Annotation für Referenztypen

Aktiviere Nullable-Annotationen für Referenztypen und die zugehörigen Compilerwarnungen. Sieh, was eine Nullprüfung für die Flussanalyse ändert und warum `string?` etwas anderes bedeutet als `int?`.

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

Syntax

#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 aktiviert sowohl Nullable-Annotationen als auch die zugehörigen Warnungen. Die Direktive gilt ab dieser Stelle in der Quelldatei bis zum Dateiende oder bis eine weitere Direktive die Einstellungen ändert. #nullable restore stellt die Projekteinstellungen wieder her, nicht die vorherigen Einstellungen in der Datei.

Ist T ein Referenztyp, erlaubt T? den Wert null, während bei T eine Referenz ungleich null erwartet wird. string und string? sind zur Laufzeit derselbe Typ und können keine Überladungen voneinander unterscheiden. Der Compiler fügt keine automatische Nullprüfung ein. Ein Memberzugriff über eine Nullreferenz kann daher weiterhin eine NullReferenceException auslösen.

Die Flussanalyse verfolgt, ob eine Referenz an einer bestimmten Stelle null sein kann. Ein Zugriff auf text.Length vor der Prüfung würde CS8602 auslösen. Durch text is null und das vorzeitige return wird der spätere Zugriff nur erreicht, wenn text nicht null ist. text! kann die Warnung unterdrücken, prüft und ändert den Wert aber nicht.

Dagegen ist int? die Kurzform von System.Nullable<int>, einem eigenen Werttyp, der auch das Fehlen eines Werts darstellen kann. string? verpackt die Referenz nicht in System.Nullable<T>.

Beispiele

#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);
}

Ergebnis

No text
3

Der erste Aufruf gibt `No text` aus und kehrt zurück, bevor er `Length` liest. Der zweite gibt `3` aus. Um `CS8602` zu sehen, entferne den Kommentar vor dem ersten Zugriff auf `text.Length` in `PrintLength` und kompiliere das Programm, ohne es auszuführen.

Zugehörige Lektionen

  • C# · Lektion 17 · Mittlere Stufe · Version: 2

Quellen