Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

`#nullable enable` e l’annotazione `T?` per i tipi riferimento

Attiva le annotazioni di nullabilità e gli avvisi del compilatore. Scopri come un controllo di `null` influisce sull’analisi del flusso e perché `string?` non funziona come `int?`.

Versione: C# 12 and .NET 8; later runtimes may add compatible features

Sintassi

#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 attiva sia le annotazioni di nullabilità sia i relativi avvisi. La direttiva si applica da quel punto del file sorgente fino a quando un’altra direttiva modifica le impostazioni o si raggiunge la fine del file. #nullable restore ripristina le impostazioni del progetto, non quelle precedenti nel file.

Se T è un tipo riferimento, T? indica che null è ammesso, mentre T indica che ci si aspetta un riferimento non nullo. string e string? sono lo stesso tipo a runtime e non permettono di distinguere due overload. Il compilatore non aggiunge controlli automatici: accedere a un membro tramite un riferimento nullo può ancora generare una NullReferenceException.

L’analisi del flusso tiene traccia dei punti in cui un riferimento potrebbe essere nullo. Accedere a text.Length prima del controllo produrrebbe CS8602. Con text is null e il return anticipato, si raggiunge l’accesso successivo solo se text non è null. Scrivere text! può sopprimere l’avviso, ma non verifica né modifica il valore.

int?, invece, è la forma abbreviata di System.Nullable<int>, un tipo valore distinto che può rappresentare anche l’assenza di un valore. string? non racchiude il riferimento in System.Nullable<T>.

Esempi

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

Risultato

No text
3

La prima chiamata stampa `No text` e termina prima di leggere `Length`. La seconda stampa `3`. Per vedere `CS8602`, rimuovi il commento dal primo accesso a `text.Length` in `PrintLength` e compila senza eseguire il programma.

Lezioni correlate

  • C# · Lezione 17 · Intermedio · Versione: 2

Fonti