Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

`#nullable enable` y la anotación `T?` para tipos de referencia

Activa las anotaciones de nulabilidad y los avisos del compilador. Observa cómo una comprobación de `null` afecta al análisis de flujo y por qué `string?` no funciona como `int?`.

Versión: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxis

#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 activa tanto las anotaciones de nulabilidad como los avisos asociados. Se aplica desde ese punto del archivo fuente hasta que otra directiva cambia esos ajustes o se llega al final del archivo. #nullable restore recupera la configuración del proyecto, no la que había antes en el archivo.

Cuando T es un tipo de referencia, T? indica que se admite null, mientras que T indica que se espera una referencia no nula. string y string? son el mismo tipo en tiempo de ejecución y no permiten distinguir sobrecargas. El compilador no añade ninguna comprobación automática, por lo que acceder a un miembro mediante una referencia nula aún puede lanzar NullReferenceException.

El análisis de flujo hace un seguimiento de si una referencia podría ser nula en cada punto del código. Acceder a text.Length antes de la comprobación provocaría CS8602. La condición text is null y el return anticipado hacen que solo se llegue al acceso posterior si text no es null. Escribir text! puede silenciar el aviso, pero no comprueba ni cambia el valor.

En cambio, int? abrevia System.Nullable<int>, un tipo de valor distinto que también puede representar la ausencia de valor. string? no envuelve la referencia en System.Nullable<T>.

Ejemplos

#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);
}

Resultado

No text
3

La primera llamada imprime `No text` y termina antes de leer `Length`. La segunda imprime `3`. Para ver `CS8602`, descomenta el primer acceso a `text.Length` en `PrintLength` y compila sin ejecutar.

Lecciones relacionadas

  • C# · Lección 17 · Intermedio · Versión: 2

Fuentes