CKTIS / C#
Nullable-referentietypen en de #nullable-context
De annotaties string en string? geven de bedoeling rond null aan, terwijl de flowanalyse van de compiler waarschuwt voor onveilig gebruik. De #nullable-context regelt annotaties en waarschuwingen afzonderlijk; er komen geen controles tijdens uitvoering bij.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
T value;
T? optional;
#nullable enable
#nullable disable
#nullable restore
#nullable enable annotations
#nullable disable warnings
#nullable restore warningsNullable-referentietypen zijn geïntroduceerd in C# 8.0 en vereisen geen previewmodus in een .NET 10-project. Als annotaties zijn ingeschakeld, staat string voor een referentie die volgens de bedoeling niet null hoort te zijn; string? staat null expliciet toe. Beide annoteren hetzelfde type tijdens uitvoering en zijn niet gelijk aan Nullable<T> voor waardetypen zoals int?.
De compiler maakt onderscheid tussen de gedeclareerde annotatie van een waarde en de null-status ervan in de flowanalyse. Aan het begin van een methode gaat de compiler er op basis van de annotaties doorgaans van uit dat een parameter van het type string niet null is en een parameter van het type string? dat wel kan zijn. Die status kan in de loop van de flowanalyse veranderen. De compiler waarschuwt wanneer een mogelijke null wordt toegewezen aan een niet-nullbare referentie of wanneer een mogelijk null-referentie wordt gedereferentieerd, bijvoorbeeld via text.Length. Na de controle text is null en het verlaten van die tak herkent de analyse dat het volgende gebruik van text veilig is. De operator text! verandert alleen de beoordeling van de compiler: hij controleert de waarde niet en voorkomt geen NullReferenceException.
De projectinstelling <Nullable>enable</Nullable> schakelt annotaties en waarschuwingen in. disable schakelt beide uit, annotations schakelt alleen annotaties in en warnings alleen waarschuwingen. Als annotaties uitstaan, zijn verwijzingen zonder ? niet op nullability gecontroleerd en kan het gebruik van ? een waarschuwing opleveren.
De directives #nullable enable en #nullable disable overschrijven de instellingen voor de volgende regels in het bestand. #nullable restore herstelt de projectinstellingen, niet de voorafgaande directive. Een optioneel doel, annotations of warnings, zoals in #nullable disable warnings, wijzigt alleen die instelling. Dit blijft gelden tot een andere toepasselijke directive of het einde van het bestand.
Dit is hulp tijdens het compileren, geen garantie tegen null tijdens uitvoering. Zo bevat new string[3] aanvankelijk null-elementen, ondanks het type string[]. Herstel de gegevensstroom en controleer waarden in plaats van waarschuwingen blind met ! te onderdrukken.
Referentie-identificatoren die in dit item worden behandeld: Nullable reference annotations and #nullable context.
Voorbeelden
#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 restoreResultaat
missing 3
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.