CKTIS / C#
`#nullable enable` i adnotacja `T?` dla typów referencyjnych
Włącz adnotacje typów referencyjnych i ostrzeżenia kompilatora. Zobacz, jak kontrola `null` zmienia wynik analizy przepływu i dlaczego `string?` nie działa tak jak `int?`.
Wersja: C# 12 and .NET 8; later runtimes may add compatible features
Składnia
#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 restoreDyrektywa #nullable enable włącza zarówno adnotacje dopuszczalności null, jak i ostrzeżenia z nimi związane. Działa od miejsca wystąpienia w pliku źródłowym aż do zmiany tych ustawień przez kolejną dyrektywę lub do końca pliku. #nullable restore przywraca ustawienia projektu, a nie poprzednie ustawienie w pliku.
Gdy T jest typem referencyjnym, T? wskazuje, że null jest dopuszczalne, a samo T oznacza, że oczekiwana jest wartość inna niż null. string i string? mają ten sam typ w czasie wykonywania i nie można na tej podstawie tworzyć odrębnych przeciążeń. Kompilator nie dodaje automatycznej kontroli null, więc dostęp do składowej przez referencję równą null nadal może spowodować NullReferenceException.
Analiza przepływu śledzi, czy w danym miejscu programu referencja może mieć wartość null. Dostęp do text.Length przed sprawdzeniem wywołałby ostrzeżenie CS8602. Warunek text is null i następujące po nim wyjście z metody przez return sprawiają, że dalszy kod jest osiągalny tylko wtedy, gdy text nie jest null. Zapis text! może wyciszyć ostrzeżenie, ale nie sprawdza ani nie zmienia wartości.
Nie myl tej adnotacji z zapisem int?: jest on skrótem od System.Nullable<int>, odrębnego typu wartościowego, który może reprezentować także brak wartości. string? nie opakowuje referencji w System.Nullable<T>.
Przykłady
#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);
}Wynik
No text 3
Pierwsze wywołanie wypisuje `No text` i kończy się przed odczytem `Length`. Drugie wypisuje `3`. Aby zobaczyć ostrzeżenie `CS8602`, odkomentuj pierwszy odczyt `text.Length` w metodzie `PrintLength` i skompiluj program bez uruchamiania.
Powiązane lekcje
- C# · Lekcja 17 · Średniozaawansowany · Wersja: 2