Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

Tipi riferimento nullable e contesto #nullable

Le annotazioni string e string? esprimono l’intenzione rispetto a null, mentre l’analisi del flusso del compilatore segnala gli usi non sicuri. Il contesto #nullable controlla separatamente annotazioni e avvisi; non aggiunge controlli in fase di esecuzione.

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

Sintassi

T value;
T? optional;
#nullable enable
#nullable disable
#nullable restore
#nullable enable annotations
#nullable disable warnings
#nullable restore warnings

I tipi riferimento nullable sono stati introdotti in C# 8.0 e non richiedono la modalità preview in un progetto .NET 10. Con le annotazioni abilitate, string indica un riferimento che, secondo l’intenzione, non dovrebbe essere null, mentre string? consente esplicitamente null. Entrambi annotano lo stesso tipo in fase di esecuzione; non equivalgono a Nullable<T> per i tipi valore come int?.

Il compilatore distingue l’annotazione dichiarata di un valore dal suo stato di null nell’analisi del flusso. All’ingresso di un metodo, in base alle annotazioni il compilatore considera di norma un parametro string non nullo e un parametro string? potenzialmente nullo. Questo stato può cambiare nel corso dell’analisi del flusso. Il compilatore segnala l’assegnazione di un possibile null a un riferimento non nullable e la dereferenziazione di un riferimento che potrebbe essere null, per esempio tramite text.Length. Dopo aver verificato text is null e aver lasciato quel ramo, l’analisi riconosce che l’uso successivo di text è sicuro. L’operatore text! modifica solo la valutazione del compilatore: non verifica il valore e non impedisce NullReferenceException.

L’impostazione di progetto <Nullable>enable</Nullable> abilita annotazioni e avvisi. disable disattiva entrambi, annotations abilita solo le annotazioni e warnings solo gli avvisi. Con le annotazioni disattivate, i riferimenti senza ? non sono soggetti all’analisi della nullabilità e l’uso di ? può generare un avviso.

Le direttive #nullable enable e #nullable disable sostituiscono le impostazioni per le righe successive del file. #nullable restore ripristina le impostazioni del progetto, non la direttiva precedente. Un obiettivo facoltativo, annotations o warnings, come in #nullable disable warnings, modifica solo il flag indicato. L’effetto dura fino a un’altra direttiva applicabile o alla fine del file.

È un aiuto in fase di compilazione, non una garanzia contro null in fase di esecuzione. Per esempio, new string[3] contiene inizialmente elementi null, nonostante il tipo string[]. Correggi il flusso dei dati e verifica i valori invece di sopprimere alla cieca gli avvisi con !.

Identificatori di riferimento trattati in questa voce: Nullable reference annotations and #nullable context.

Esempi

#nullable enable
using System;

internal static class Program
{
    private static void Main()
    {
        PrintLength(null);
        PrintLength("Ada");
    }

    private static void PrintLength(string? text)
    {
        if (text is null)
        {
            Console.WriteLine("missing");
            return;
        }

        Console.WriteLine(text.Length);
    }
}
#nullable restore

Risultato

missing
3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti