Enumerable.Empty<TResult> Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Исходный код:

Enumerable.SpeedOpt.cs

Возвращает пустую коллекцию IEnumerable<T> с указанным аргументом типа.

C#

public static System.Collections.Generic.IEnumerable<TResult> Empty<TResult> ();

Параметры типа

TResult

Тип, присваиваемый параметру типа возвращаемого универсального интерфейса IEnumerable<T>.

Возвращаемое значение

IEnumerable<TResult>

Пустая коллекция IEnumerable<T> с аргументом типа TResult.

Примеры

В следующем примере кода показано, как использовать Empty<TResult>() для создания пустого IEnumerable<T>объекта .

C#

IEnumerable<decimal> empty = Enumerable.Empty<decimal>();

В следующем примере кода показано возможное Empty<TResult>() применение метода . Метод Aggregate применяется к коллекции массивов строк. Элементы каждого массива в коллекции добавляются в результирующий IEnumerable<T> только в том случае, если этот массив содержит четыре или более элементов. Empty используется для создания начального значения для , Aggregate так как если ни один массив в коллекции не содержит четырех или более элементов, возвращается только пустая последовательность.

C#

string[] names1 = { "Hartono, Tommy" };
string[] names2 = { "Adams, Terry", "Andersen, Henriette Thaulow",
                      "Hedlund, Magnus", "Ito, Shu" };
string[] names3 = { "Solanki, Ajay", "Hoeing, Helge",
                      "Andersen, Henriette Thaulow",
                      "Potra, Cristina", "Iallo, Lucio" };

List<string[]> namesList =
    new List<string[]> { names1, names2, names3 };

// Only include arrays that have four or more elements
IEnumerable<string> allNames =
    namesList.Aggregate(Enumerable.Empty<string>(),
    (current, next) => next.Length > 3 ? current.Union(next) : current);

foreach (string name in allNames)
{
    Console.WriteLine(name);
}

/*
 This code produces the following output:

 Adams, Terry
 Andersen, Henriette Thaulow
 Hedlund, Magnus
 Ito, Shu
 Solanki, Ajay
 Hoeing, Helge
 Potra, Cristina
 Iallo, Lucio
*/

Комментарии

Метод Empty<TResult>() кэширует пустую последовательность типа TResult. При перечислении возвращаемого им объекта элементы не возвращаются.

В некоторых случаях этот метод удобен для передачи пустой последовательности в определяемый пользователем IEnumerable<T>метод, который принимает . Его также можно использовать для создания нейтрального элемента для таких методов, как Union. Пример использования Empty<TResult>()см. в разделе Пример.

Применяется к