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

CKTIS / C#

Array.Empty<T> — una matriz vacía de un tipo determinado

Array.Empty<T>() devuelve una matriz no nula de tipo T[] y longitud cero. Usa este método para representar que no hay elementos sin crear una nueva matriz vacía en cada llamada.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

Array.Empty<T>()

Array.Empty<T> es un método estático de System.Array, disponible en .NET 10. Su declaración es public static T[] Empty<T>();. El parámetro de tipo T especifica el tipo de los elementos; por ejemplo, Array.Empty<string>() devuelve una matriz string[] vacía. El método no recibe argumentos.

El resultado no es null: su Length es 0 y un bucle foreach no realiza ninguna iteración. Esto permite representar «ningún elemento» sin comprobar si es null antes de recorrer la matriz. Sin embargo, una matriz vacía no tiene ningún elemento en el índice 0: no leas ni escribas en ese índice.

Usa Array.Empty<T>() en lugar de new T[0] cuando necesites una matriz vacía. Para un T determinado, el método utiliza una instancia vacía compartida y evita asignaciones repetidas de matrices vacías. No lo consideres una forma de crear un objeto distinto en cada llamada; la regla del analizador CA1825 recomienda este reemplazo.

El ejemplo imprime la longitud de la matriz y el resultado de comprobar si es null. El bucle no imprime nada. Esta es una API de la biblioteca .NET, no una característica del lenguaje que requiera LangVersion=preview.

Ejemplos

using System;

internal static class Program
{
    private static void Main()
    {
        string[] names = Array.Empty<string>();
        Console.WriteLine(names.Length);
        Console.WriteLine(names is null);

        foreach (string name in names)
        {
            Console.WriteLine(name);
        }
    }
}

Resultado

0
False

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.

Fuentes