CKTIS / C#
`#nullable enable` a anotace `T?` pro referenční typy
Zapněte anotace referenčních typů a upozornění kompilátoru. Zjistěte, jak kontrola hodnoty `null` ovlivňuje analýzu toku a proč `string?` nefunguje stejně jako `int?`.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
#nullable enable
// T? denotes a nullable reference when T is a reference type.
static void ShowLength(string? text)
{
if (text is not null)
System.Console.WriteLine(text.Length);
}
#nullable restore#nullable enable zapíná anotace pro práci s hodnotou null i související upozornění. Direktiva platí od daného místa ve zdrojovém souboru až do konce souboru nebo dokud toto nastavení nezmění jiná direktiva. #nullable restore obnoví nastavení projektu, nikoli předchozí nastavení v souboru.
Je-li T referenční typ, T? připouští null, zatímco T znamená, že se očekává reference jiná než null. string a string? jsou za běhu stejný typ a nelze jimi rozlišit přetížení. Kompilátor nevkládá automatickou kontrolu, takže přístup ke členu přes referenci s hodnotou null může stále vyvolat NullReferenceException.
Analýza toku sleduje, zda reference může na daném místě obsahovat null. Přístup k text.Length před kontrolou by vyvolal upozornění CS8602. Díky podmínce text is null a předčasnému return se k pozdějšímu přístupu dojde, jen když text není null. Zápis text! může upozornění potlačit, ale hodnotu nekontroluje ani nemění.
Naproti tomu int? je zkratka pro System.Nullable<int>, samostatný hodnotový typ, který může vyjádřit i nepřítomnost hodnoty. string? neobaluje referenci do typu System.Nullable<T>.
Příklady
#nullable enable
using System;
PrintLength(null);
PrintLength("Ada");
static void PrintLength(string? text)
{
// Console.WriteLine(text.Length); // CS8602
if (text is null)
{
Console.WriteLine("No text");
return;
}
Console.WriteLine(text.Length);
}Výsledek
No text 3
První volání vypíše `No text` a skončí před čtením `Length`. Druhé vypíše `3`. Chcete-li zobrazit `CS8602`, odkomentujte první přístup k `text.Length` v metodě `PrintLength` a program sestavte bez spuštění.
Související lekce
- C# · Lekce 17 · Středně pokročilá · Verze: 2