Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła