CKTIS / C#
`#nullable enable` en de `T?`-annotatie voor referentietypen
Schakel null-annotaties voor referentietypen en bijbehorende compilerwaarschuwingen in. Bekijk hoe een null-controle de stroomanalyse beïnvloedt en waarom `string?` verschilt van `int?`.
Versie: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
#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 schakelt zowel null-annotaties als de bijbehorende waarschuwingen in. De richtlijn geldt vanaf die plek in het bronbestand totdat een andere richtlijn die instellingen wijzigt of het bestand eindigt. #nullable restore herstelt de projectinstellingen, niet de vorige instellingen in het bestand.
Als T een referentietype is, geeft T? aan dat null is toegestaan. Bij T wordt een niet-nullreferentie verwacht. string en string? zijn tijdens de uitvoering hetzelfde type en kunnen niet dienen om overbelastingen te onderscheiden. De compiler voegt geen automatische null-controle toe; toegang tot een lid via een nullreferentie kan dus nog steeds een NullReferenceException veroorzaken.
De stroomanalyse houdt bij waar een referentie mogelijk null is. Toegang tot text.Length vóór de controle zou CS8602 opleveren. Door text is null en de vroege return wordt de latere toegang alleen bereikt als text niet null is. Met text! kun je de waarschuwing onderdrukken, maar je controleert of verandert de waarde daarmee niet.
int? is daarentegen een verkorte schrijfwijze voor System.Nullable<int>, een afzonderlijk waardetype dat ook de afwezigheid van een waarde kan voorstellen. string? verpakt de referentie niet in System.Nullable<T>.
Voorbeelden
#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);
}Resultaat
No text 3
De eerste aanroep schrijft `No text` en keert terug voordat `Length` wordt gelezen. De tweede schrijft `3`. Haal de eerste toegang tot `text.Length` in `PrintLength` uit het commentaar en bouw het project zonder het uit te voeren om `CS8602` te zien.
Gerelateerde lessen
- C# · Les 17 · Gemiddeld · Versie: 2