База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници