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

CKTIS / C#

`#nullable enable` e a anotação `T?` para tipos de referência

Ativa as anotações para referências que admitem `null` e os avisos do compilador. Vê como uma verificação de `null` afeta a análise de fluxo e por que razão `string?` difere de `int?`.

Versão: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxe

#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 ativa tanto as anotações de nulabilidade como os avisos correspondentes. Aplica-se a partir desse ponto no ficheiro de código-fonte até que outra diretiva altere essas definições ou se chegue ao fim do ficheiro. #nullable restore repõe as definições do projeto, não as definições anteriores no ficheiro.

Quando T é um tipo de referência, T? indica que null é permitido, enquanto T indica que se espera uma referência não nula. string e string? são o mesmo tipo em tempo de execução e não permitem distinguir sobrecargas. O compilador não acrescenta verificações automáticas: aceder a um membro através de uma referência nula pode continuar a lançar NullReferenceException.

A análise de fluxo acompanha os pontos em que uma referência pode ser nula. Aceder a text.Length antes da verificação provocaria CS8602. A condição text is null e o return antecipado garantem que só se chega ao acesso posterior se text não for null. Escrever text! pode suprimir o aviso, mas não verifica nem altera o valor.

Já int? é a forma abreviada de System.Nullable<int>, um tipo de valor distinto que também pode representar a ausência de valor. string? não envolve a referência em System.Nullable<T>.

Exemplos

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

Resultado

No text
3

A primeira chamada escreve `No text` e termina antes de ler `Length`. A segunda escreve `3`. Para veres `CS8602`, descomenta o primeiro acesso a `text.Length` em `PrintLength` e compila sem executar.

Lições relacionadas

  • C# · Lição 17 · Intermédio · Versão: 2

Fontes