Enumerable.Empty<TResult> Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Source:

Enumerable.SpeedOpt.cs

Retourne un IEnumerable<T> vide qui a l'argument de type spécifié.

C#

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

Paramètres de type

TResult

Type à assigner au paramètre de type du IEnumerable<T> générique retourné.

Retours

IEnumerable<TResult>

IEnumerable<T> vide dont l'argument de type est TResult.

Exemples

L’exemple de code suivant montre comment utiliser Empty<TResult>() pour générer un vide IEnumerable<T>.

C#

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

L’exemple de code suivant illustre une application possible de la Empty<TResult>() méthode. La Aggregate méthode est appliquée à une collection de tableaux de chaînes. Les éléments de chaque tableau de la collection sont ajoutés au résultat IEnumerable<T> uniquement si ce tableau contient quatre éléments ou plus. Empty est utilisé pour générer la valeur initiale pour Aggregate , car si aucun tableau de la collection n’a quatre éléments ou plus, seule la séquence vide est retournée.

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

Remarques

La Empty<TResult>() méthode met en cache une séquence vide de type TResult. Lorsque l’objet qu’il retourne est énuméré, il ne génère aucun élément.

Dans certains cas, cette méthode est utile pour passer une séquence vide à une méthode définie par l’utilisateur qui prend un IEnumerable<T>. Il peut également être utilisé pour générer un élément neutre pour des méthodes telles que Union. Consultez la section Exemple pour obtenir un exemple d’utilisation de Empty<TResult>().

S’applique à