CKTIS / C#
NullReferenceException – Verwendung einer Nullreferenz
System.NullReferenceException weist auf den Versuch hin, null zu dereferenzieren, etwa beim Lesen einer Eigenschaft eines nicht vorhandenen Objekts. Erfahre, wodurch der Fehler entsteht, welche Rolle die Nullable-Analyse spielt und worin sich !, ?. und ?? unterscheiden.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
try { /* dereference */ } catch (System.NullReferenceException ex) { /* diagnostic handling */ }System.NullReferenceException wird ausgelöst, wenn Code versucht, null zu dereferenzieren, zum Beispiel beim Lesen von text.Length, wenn text den Wert null hat. Prüfe die von der Aufrufliste angegebene Stelle sowie Zwischenwerte in einer Kette von Eigenschaftszugriffen.
Bei aktivierter Nullable-Analyse zeigt string? an, dass eine Referenz null sein kann. Compilerwarnungen helfen, Risiken zu erkennen, bieten aber keinen Schutz zur Laufzeit. Der Operator ! unterdrückt lediglich Nullable-Warnungen: text!.Length löst weiterhin eine Ausnahme aus, wenn text null ist.
Behebe die Ursache: Initialisiere das Objekt oder behandle sein Fehlen ausdrücklich. Wenn ein fehlender Wert zulässig ist, gibt text?.Length ?? 0 bei null den Wert 0 zurück. Diese Ausnahme zu verhindern ist in der Regel besser, als sie abzufangen. Das Beispiel verwendet catch nur zur Demonstration; verwende es nicht als übliche Methode, um null zu prüfen.
Beispiele
#nullable enable
using System;
internal static class Program
{
private static void Main()
{
string? text = null;
try
{
Console.WriteLine(text!.Length);
}
catch (System.NullReferenceException ex)
{
Console.WriteLine(ex.GetType().Name);
}
Console.WriteLine(text?.Length ?? 0);
}
}Ergebnis
NullReferenceException 0
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.