Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

NullReferenceException — utilização de uma referência null

System.NullReferenceException indica uma tentativa de desreferenciar null, por exemplo, ao ler uma propriedade de um objeto que não existe. Saiba qual é a causa, qual o papel da análise de nulabilidade e em que diferem !, ?. e ??.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

try { /* dereference */ } catch (System.NullReferenceException ex) { /* diagnostic handling */ }

System.NullReferenceException é lançada quando o código tenta desreferenciar null, por exemplo, ao ler text.Length quando text tem o valor null. Verifique a localização indicada pela pilha de chamadas e os valores intermédios numa cadeia de acesso a propriedades.

Com a análise de nulabilidade ativada, string? indica que uma referência pode ser null. Os avisos do compilador ajudam a identificar riscos, mas não oferecem proteção em tempo de execução. O operador ! apenas suprime os avisos de nulabilidade: text!.Length continua a lançar uma exceção se text for null.

Corrija a causa: inicialize o objeto ou trate explicitamente a sua ausência. Se for permitido não existir um valor, text?.Length ?? 0 devolve 0 quando o valor é null. Normalmente, é preferível evitar esta exceção a capturá-la. O exemplo utiliza catch apenas para demonstração; não o considere uma forma habitual de verificar se um valor é null.

Exemplos

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

Resultado

NullReferenceException
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes