Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

C# — `#nullable enable`, `string?` e `[NotNullWhen(true)]` per due parametri `out`

Attiva l’analisi della nullabilità e descrivi entrambe le uscite di un metodo `Try*` affinché il compilatore sappia che nessuna delle due è `null` in caso di successo.

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

Sintassi

#nullable enable
using System.Diagnostics.CodeAnalysis;

static bool TryGetLabels(
    string key,
    [NotNullWhen(true)] out string? primary,
    [NotNullWhen(true)] out string? secondary)

In C# 12 su .NET 8, #nullable enable abilita le annotazioni di nullabilità e i relativi avvisi per le righe successive, finché un’altra direttiva non cambia il contesto o si raggiunge la fine del file. string? ammette null; string dichiara un riferimento che non dovrebbe essere null. Il tipo a runtime è lo stesso e l’annotazione non aggiunge controlli a runtime.

[NotNullWhen(true)] è la forma abbreviata dell’attributo NotNullWhenAttribute dello spazio dei nomi System.Diagnostics.CodeAnalysis. Su un parametro out string? indica che, se il metodo restituisce true, quella specifica uscita non è null. La garanzia vale solo per il parametro annotato, quindi TryGetLabels annota primary e secondary separatamente.

Il metodo deve assegnare un valore a entrambi i parametri out prima di ogni ritorno normale. Per "menu", questa implementazione fornisce "Open" e "Close" e restituisce true. Per un’altra chiave, assegna null a entrambi e restituisce false. È una scelta dell’implementazione: l’attributo non impone che una delle uscite sia null quando il valore restituito è false.

Nel ramo if, il compilatore considera entrambi i riferimenti non nulli, quindi puoi leggere entrambe le proprietà Length senza !. Nel ramo else, entrambi i valori sono considerati potenzialmente nulli; ?? fornisce un testo sostitutivo. L’attributo non impone il contratto a runtime. Per confronto, [MaybeNull] ammette un’uscita potenzialmente nulla nonostante una dichiarazione non nullable, mentre [MemberNotNull] descrive lo stato dei campi o delle proprietà indicati al ritorno di un metodo, non quello dei parametri out.

Esempi

#nullable enable
using System;
using System.Diagnostics.CodeAnalysis;

foreach (string key in new[] { "menu", "other" })
{
    if (TryGetLabels(key, out string? primary, out string? secondary))
    {
        Console.WriteLine($"{primary.Length}, {secondary.Length}");
    }
    else
    {
        Console.WriteLine($"{primary ?? "<null>"}, {secondary ?? "<null>"}");
    }
}

static bool TryGetLabels(
    string key,
    [NotNullWhen(true)] out string? primary,
    [NotNullWhen(true)] out string? secondary)
{
    if (key == "menu")
    {
        primary = "Open";
        secondary = "Close";
        return true;
    }

    primary = null;
    secondary = null;
    return false;
}

Risultato

4, 5
<null>, <null>

La prima riga contiene le lunghezze delle due etichette; la seconda mostra entrambi i segnaposto per `null`. Rimuovi l’attributo soltanto da `secondary` e ricompila: è previsto CS8602 su `secondary.Length`, ma non su `primary.Length`.

Lezioni correlate

  • C# · Lezione 53 · Avanzato · Versione: 3

Fonti