Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

Array.Empty<T> — un array vuoto di un tipo specificato

Array.Empty<T>() restituisce un array non null di tipo T[] con lunghezza zero. Usa questo metodo per rappresentare l’assenza di elementi senza creare un nuovo array vuoto a ogni chiamata.

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

Sintassi

Array.Empty<T>()

Array.Empty<T> è un metodo statico di System.Array, disponibile in .NET 10. La sua dichiarazione è public static T[] Empty<T>();. Il parametro di tipo T specifica il tipo degli elementi; per esempio, Array.Empty<string>() restituisce un array string[] vuoto. Il metodo non accetta argomenti.

Il risultato non è null: la sua Length è 0 e un ciclo foreach non esegue alcuna iterazione. In questo modo puoi rappresentare «nessun elemento» senza controllare se il valore è null prima di iterare. Tuttavia, un array vuoto non ha alcun elemento all’indice 0: non leggere né scrivere a quell’indice.

Usa Array.Empty<T>() invece di new T[0] quando hai bisogno di un array vuoto. Per un determinato T, il metodo usa un’istanza vuota condivisa, evitando allocazioni ripetute di array vuoti. Non considerarlo un modo per creare un oggetto distinto a ogni chiamata; la regola dell’analizzatore CA1825 consiglia questa sostituzione.

L’esempio stampa la lunghezza dell’array e il risultato del controllo null. Il ciclo non stampa nulla. Questa è un’API della libreria .NET, non una funzionalità sintattica che richiede LangVersion=preview.

Esempi

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

Risultato

0
False

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti