Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Array.Empty<T> — um array vazio de um tipo especificado

Array.Empty<T>() devolve um array não nulo do tipo T[] com comprimento zero. Utilize este método para representar a ausência de elementos sem criar um novo array vazio em cada chamada.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

Array.Empty<T>()

Array.Empty<T> é um método estático de System.Array, disponível no .NET 10. A sua declaração é public static T[] Empty<T>();. O parâmetro de tipo T especifica o tipo dos elementos; por exemplo, Array.Empty<string>() devolve um array string[] vazio. O método não aceita argumentos.

O resultado não é null: o seu Length é 0 e um ciclo foreach não realiza nenhuma iteração. Assim, pode representar «nenhum elemento» sem verificar se o valor é null antes de iterar. No entanto, um array vazio não tem qualquer elemento no índice 0 — não leia nem escreva nesse índice.

Utilize Array.Empty<T>() em vez de new T[0] quando precisar de um array vazio. Para um dado T, o método utiliza uma instância vazia partilhada, evitando alocações repetidas de arrays vazios. Não o encare como uma forma de criar um objeto distinto em cada chamada; a regra do analisador CA1825 recomenda esta substituição.

O exemplo apresenta o comprimento do array e o resultado de uma verificação de null. O ciclo não apresenta nada. Esta é uma API da biblioteca .NET, não uma funcionalidade de sintaxe que exija LangVersion=preview.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes