CKTIS / C#
C# — `#nullable enable`, `string?` in `[NotNullWhen(true)]` za dva parametra `out`
Omogoči analizo vrednosti `null` in opiši oba izhoda metode `Try*`, da prevajalnik ve, da ob uspehu nobeden ni `null`.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
#nullable enable
using System.Diagnostics.CodeAnalysis;
static bool TryGetLabels(
string key,
[NotNullWhen(true)] out string? primary,
[NotNullWhen(true)] out string? secondary)V C# 12 na .NET 8 #nullable enable za naslednje vrstice vklopi označevanje, ali so dovoljene vrednosti null, in povezana opozorila. Velja, dokler druga direktiva ne spremeni konteksta ali do konca datoteke. string? dopušča null; string deklarira referenco, ki naj ne bi bila null. Tip je med izvajanjem enak in oznaka ne doda preverjanja med izvajanjem.
[NotNullWhen(true)] je skrajšani zapis atributa NotNullWhenAttribute iz imenskega prostora System.Diagnostics.CodeAnalysis. Na parametru out string? pomeni, da prav ta izhod ni null, če metoda vrne true. Zagotovilo velja samo za označeni parameter, zato TryGetLabels označi primary in secondary ločeno.
Metoda mora pred vsako običajno vrnitvijo dodeliti vrednost obema parametroma out. Za "menu" ta implementacija poda "Open" in "Close" ter vrne true. Za drug ključ obema dodeli null in vrne false. To je odločitev implementacije: atribut ne zahteva, da je kateri od izhodov null, kadar metoda vrne false.
V veji if prevajalnik obe referenci obravnava kot različni od null, zato lahko prebereš obe lastnosti Length brez !. V veji else obravnava obe vrednosti kot morebitni null; ?? poda nadomestno besedilo. Atribut pogodbe ne uveljavlja med izvajanjem. Za primerjavo: [MaybeNull] dopušča, da je izhod null kljub deklaraciji, ki tega ne dovoljuje, [MemberNotNull] pa po vrnitvi iz metode opisuje stanje navedenih polj ali lastnosti, ne parametrov out.
Primeri
#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;
}Rezultat
4, 5 <null>, <null>
V prvi vrstici sta dolžini obeh oznak, v drugi pa oba prikaza za `null`. Odstrani atribut samo s parametra `secondary` in znova prevedi: pričakuj CS8602 pri `secondary.Length`, ne pa pri `primary.Length`.
Povezane lekcije
- C# · Lekcija 53 · Napredna · Različica: 3