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