CKTIS / C#
Array.Empty<T> — празен масив от зададен тип
Array.Empty<T>() връща масив от тип T[] с дължина нула, който не е null. Използвайте този метод, за да представите липсата на елементи, без при всяко извикване да създавате нов празен масив.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
Array.Empty<T>()Array.Empty<T> е статичен метод на System.Array, наличен в .NET 10. Декларацията му е public static T[] Empty<T>();. Параметърът на типа T задава типа на елементите; например Array.Empty<string>() връща празен масив string[]. Методът не приема аргументи.
Резултатът не е null: неговото Length е 0, а цикълът foreach не изпълнява нито една итерация. Така можете да представите „няма елементи“, без преди обхождането да проверявате за null. Празният масив обаче няма елемент с индекс 0 — не четете от този индекс и не записвайте в него.
Когато ви е необходим празен масив, използвайте Array.Empty<T>() вместо new T[0]. За даден T методът използва споделен празен екземпляр и така избягва многократното заделяне на празни масиви. Не го разглеждайте като начин при всяко извикване да създавате отделен обект; правилото на анализатора CA1825 препоръчва тази замяна.
Примерът извежда дължината на масива и резултата от проверката за null. Цикълът не извежда нищо. Това е API на библиотеката .NET, а не синтактична възможност, за която е необходим LangVersion=preview.
Примери
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);
}
}
}Резултат
0 False
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.