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.