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