CKTIS / C#
NullReferenceException — użycie referencji null
System.NullReferenceException oznacza próbę dereferencji null, np. odczyt właściwości obiektu, który nie istnieje. Poznaj przyczynę błędu, rolę analizy nullable oraz różnicę między operatorami !, ?. i ??.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
try { /* dereference */ } catch (System.NullReferenceException ex) { /* diagnostic handling */ }System.NullReferenceException jest wyjątkiem zgłaszanym przy próbie dereferencji null, np. podczas odczytu text.Length, gdy text ma wartość null. Sprawdź miejsce wskazane przez stos wywołań oraz wartości pośrednie w łańcuchu dostępu do właściwości.
Przy włączonej analizie nullable zapis string? informuje, że referencja może być null. Ostrzeżenia kompilatora pomagają wykrywać ryzyko, ale nie stanowią zabezpieczenia w czasie wykonania. Operator ! jedynie wycisza ostrzeżenia dotyczące null: text!.Length nadal zgłosi wyjątek, jeśli text jest null.
Napraw przyczynę: zainicjalizuj obiekt albo jawnie obsłuż jego brak. Jeśli brak wartości jest dozwolony, text?.Length ?? 0 zwróci 0 dla null. Zwykle lepiej zapobiegać temu wyjątkowi niż go przechwytywać. Przykład używa catch wyłącznie do demonstracji; nie traktuj go jako zwykłego sposobu sprawdzania null.
Przykłady
#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);
}
}Wynik
NullReferenceException 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.