Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Array.Empty<T> — pusta tablica określonego typu

Array.Empty<T>() zwraca niebędącą null tablicę typu T[] o długości zero. Używaj tej metody do reprezentowania braku elementów bez tworzenia nowej pustej tablicy przy każdym wywołaniu.

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

Składnia

Array.Empty<T>()

Array.Empty<T> to statyczna metoda klasy System.Array, dostępna w .NET 10. Jej deklaracja to public static T[] Empty<T>();. Parametr typu T określa typ elementów; na przykład Array.Empty<string>() zwraca pustą tablicę string[]. Metoda nie przyjmuje argumentów.

Wynik nie jest null: jego Length wynosi 0, a pętla foreach nie wykonuje żadnej iteracji. Pozwala to reprezentować „brak elementów” bez konieczności sprawdzania null przed iteracją. Pusta tablica nie ma jednak elementu pod indeksem 0 — nie należy go odczytywać ani zapisywać.

Zamiast new T[0] użyj Array.Empty<T>(), gdy potrzebujesz pustej tablicy. Metoda korzysta ze współdzielonej pustej instancji dla danego T, unikając powtarzanych alokacji pustych tablic. Nie traktuj jej jako sposobu tworzenia odrębnego obiektu przy każdym wywołaniu; reguła analizatora CA1825 zaleca takie zastąpienie.

Przykład wypisuje długość tablicy i wynik sprawdzenia null. Pętla nie wypisuje niczego. Jest to API biblioteki .NET, a nie funkcja składniowa wymagająca LangVersion=preview.

Przykłady

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

Wynik

0
False

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła