Enumerable.Empty<TResult> Metoda

Definicja

Przestrzeń nazw:

System.Linq

Zestaw:

System.Linq.dll

Źródło:

Enumerable.SpeedOpt.cs

Zwraca pusty IEnumerable<T> argument o określonym typie.

C#

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

Parametry typu

TResult

Typ, który ma zostać przypisany do parametru typu zwróconego ogólnego IEnumerable<T>.

Zwraca

IEnumerable<TResult>

IEnumerable<T> Puste, którego argumentem typu jest TResult.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć Empty<TResult>() polecenia w celu wygenerowania pustego IEnumerable<T>elementu .

C#

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

Poniższy przykład kodu przedstawia możliwe zastosowanie Empty<TResult>() metody. Metoda Aggregate jest stosowana do kolekcji tablic ciągów. Elementy każdej tablicy w kolekcji są dodawane do wynikowej IEnumerable<T> tylko wtedy, gdy ta tablica zawiera co najmniej cztery elementy. Empty służy do generowania wartości inicjowanej, Aggregate ponieważ jeśli żadna tablica w kolekcji nie ma co najmniej czterech elementów, zwracana jest tylko pusta sekwencja.

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
*/

Uwagi

Metoda Empty<TResult>() buforuje pustą sekwencję typu TResult. Gdy zwracany obiekt zostanie wyliczony, nie daje żadnych elementów.

W niektórych przypadkach ta metoda jest przydatna do przekazywania pustej sekwencji do metody zdefiniowanej przez użytkownika, która przyjmuje metodę IEnumerable<T>. Można go również użyć do wygenerowania neutralnego elementu dla metod, takich jak Union. Zobacz sekcję Przykład, aby zapoznać się z przykładem użycia elementu Empty<TResult>().

Dotyczy