CKTIS / C#
Nullable referenčni tipi in kontekst #nullable
Pripisi string in string? izražajo namen glede vrednosti null, analiza toka v prevajalniku pa opozarja na nevarno uporabo. Kontekst #nullable ločeno upravlja pripise in opozorila; ne dodaja preverjanj med izvajanjem.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
T value;
T? optional;
#nullable enable
#nullable disable
#nullable restore
#nullable enable annotations
#nullable disable warnings
#nullable restore warningsNullable referenčni tipi so bili uvedeni v C# 8.0 in v projektu .NET 10 ne zahtevajo načina preview. Ko so pripisi omogočeni, string označuje referenco, ki po namenu ne bi smela biti null, string? pa null izrecno dovoljuje. Oba pripisa se nanašata na isti tip med izvajanjem; nista enakovredna Nullable<T> za vrednostne tipe, kot je int?.
Prevajalnik razlikuje med deklariranim pripisom vrednosti in stanjem, ki ga pri analizi toka vodi glede možnosti, da je vrednost null. Na začetku metode na podlagi pripisov praviloma predpostavi, da parameter tipa string ni null, parameter tipa string? pa je lahko null. To stanje se lahko med analizo toka spremeni. Prevajalnik opozori na dodelitev možne vrednosti null nenullabilni referenci in na dereferenciranje morebitne null reference, na primer z text.Length. Po preverjanju text is null in izhodu iz te veje analiza prepozna, da je nadaljnja uporaba text varna. Operator text! spremeni samo oceno prevajalnika: vrednosti ne preveri in ne prepreči NullReferenceException.
Projektna nastavitev <Nullable>enable</Nullable> omogoči pripise in opozorila. disable izklopi oboje, annotations omogoči samo pripise, warnings pa samo opozorila. Ko so pripisi izklopljeni, se pri referencah brez ? ne spremlja ničelnost, uporaba ? pa lahko povzroči opozorilo.
Direktivi #nullable enable in #nullable disable prepišeta nastavitve za naslednje vrstice datoteke. #nullable restore obnovi projektne nastavitve, ne prejšnje direktive. Izbirni cilj annotations ali warnings, na primer #nullable disable warnings, spremeni samo ustrezno zastavico. Učinek traja do naslednje ustrezne direktive ali do konca datoteke.
To je pomoč pri prevajanju, ne zagotovilo proti null med izvajanjem. Na primer, new string[3] sprva vsebuje elemente null, čeprav je tip tega polja string[]. Popravite tok podatkov in preverjajte vrednosti, namesto da bi opozorila slepo utišali z !.
Referenčni identifikatorji, zajeti v tem geslu: Nullable reference annotations and #nullable context.
Primeri
#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 restoreRezultat
missing 3
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.