CKTIS / C#
Tipos de referencia anulables y contexto #nullable
Las anotaciones string y string? expresan la intención respecto a null, mientras que el análisis de flujo del compilador advierte sobre usos inseguros. El contexto #nullable controla por separado las anotaciones y las advertencias; no añade comprobaciones en tiempo de ejecución.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
T value;
T? optional;
#nullable enable
#nullable disable
#nullable restore
#nullable enable annotations
#nullable disable warnings
#nullable restore warningsLos tipos de referencia anulables se introdujeron en C# 8.0 y no requieren el modo preview en un proyecto .NET 10. Con las anotaciones habilitadas, string indica una referencia que, según la intención, no debería ser null, mientras que string? permite explícitamente null. Ambos anotan el mismo tipo en tiempo de ejecución; no equivalen a Nullable<T> para tipos de valor como int?.
El compilador distingue entre la anotación declarada de un valor y su estado de nulabilidad en el análisis de flujo. Al entrar en un método, el compilador normalmente considera, según las anotaciones, que un parámetro string no es null y que un parámetro string? puede serlo. Este estado puede cambiar a medida que avanza el análisis de flujo. El compilador advierte cuando se asigna un posible null a una referencia no anulable o se desreferencia una referencia posiblemente nula, por ejemplo mediante text.Length. Tras comprobar text is null y salir de esa rama, el análisis reconoce que el uso posterior de text es seguro. El operador text! solo cambia la evaluación del compilador: no comprueba el valor ni evita NullReferenceException.
La opción del proyecto <Nullable>enable</Nullable> habilita las anotaciones y las advertencias. disable desactiva ambas, annotations habilita solo las anotaciones y warnings solo las advertencias. Con las anotaciones desactivadas, las referencias sin ? se consideran ajenas al análisis de nulabilidad, y el uso de ? puede producir una advertencia.
Las directivas #nullable enable y #nullable disable reemplazan la configuración para las líneas siguientes del archivo. #nullable restore restaura la configuración del proyecto, no la directiva anterior. Un destino opcional, annotations o warnings, como en #nullable disable warnings, modifica únicamente esa opción. El efecto continúa hasta otra directiva aplicable o hasta el final del archivo.
Esto es una ayuda en tiempo de compilación, no una garantía contra null en tiempo de ejecución. Por ejemplo, new string[3] contiene inicialmente elementos null, a pesar de su tipo string[]. Corrige el flujo de datos y comprueba los valores en vez de suprimir advertencias a ciegas con !.
Identificadores de referencia incluidos en esta entrada: Nullable reference annotations and #nullable context.
Ejemplos
#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 restoreResultado
missing 3
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.