Enumerable.ToLookup Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Crée une Lookup<TKey,TElement> générique à partir de IEnumerable<T>.

Surcharges

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	Crée un Lookup<TKey,TElement> à partir de IEnumerable<T> selon des fonctions de sélection de clé et de sélection d'élément spécifiées.
ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Crée une Lookup<TKey,TElement> à partir de IEnumerable<T> selon une fonction de sélection de clé spécifiée, un comparateur et une fonction de sélection d'élément.
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Crée un Lookup<TKey,TElement> à partir de IEnumerable<T> selon une fonction de sélection de clé spécifiée et un comparateur de clé.
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Crée un Lookup<TKey,TElement> à partir d'un IEnumerable<T> selon une fonction de sélection de clé spécifiée.

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)

Source:

Lookup.cs

Crée un Lookup<TKey,TElement> à partir de IEnumerable<T> selon des fonctions de sélection de clé et de sélection d'élément spécifiées.

C#

public static System.Linq.ILookup<TKey,TElement> ToLookup<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector);

Paramètres de type

TSource

Le type des éléments de source.

TKey

Type de clé retournée par keySelector.

TElement

Type de la valeur retournée par elementSelector.

Paramètres

source

IEnumerable<TSource>

IEnumerable<T> à partir duquel créer un Lookup<TKey,TElement>.

keySelector

Func<TSource,TKey>

Fonction permettant d'extraire une clé de chaque élément.

elementSelector

Func<TSource,TElement>

Fonction de transformation permettant de produire une valeur d'élément de résultat à partir de chaque élément.

Retours

ILookup<TKey,TElement>

Lookup<TKey,TElement> qui contient des valeurs de type TElement sélectionnées dans la séquence d’entrée.

Exceptions

ArgumentNullException

source ou keySelector ou elementSelector a la valeur null.

Exemples

L’exemple de code suivant montre comment utiliser ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) pour créer un Lookup<TKey,TElement> à l’aide d’une fonction de sélecteur de clé et d’une fonction de sélecteur d’élément.

C#

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
    public long TrackingNumber { get; set; }
}

public static void ToLookupEx1()
{
    // Create a list of Packages.
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard",
                  Weight = 25.2, TrackingNumber = 89453312L },
              new Package { Company = "Lucerne Publishing",
                  Weight = 18.7, TrackingNumber = 89112755L },
              new Package { Company = "Wingtip Toys",
                  Weight = 6.0, TrackingNumber = 299456122L },
              new Package { Company = "Contoso Pharmaceuticals",
                  Weight = 9.3, TrackingNumber = 670053128L },
              new Package { Company = "Wide World Importers",
                  Weight = 33.8, TrackingNumber = 4665518773L } };

    // Create a Lookup to organize the packages.
    // Use the first character of Company as the key value.
    // Select Company appended to TrackingNumber
    // as the element values of the Lookup.
    ILookup<char, string> lookup =
        packages
        .ToLookup(p => p.Company[0],
                  p => p.Company + " " + p.TrackingNumber);

    // Iterate through each IGrouping in the Lookup.
    foreach (IGrouping<char, string> packageGroup in lookup)
    {
        // Print the key value of the IGrouping.
        Console.WriteLine(packageGroup.Key);
        // Iterate through each value in the
        // IGrouping and print its value.
        foreach (string str in packageGroup)
            Console.WriteLine("    {0}", str);
    }
}

/*
 This code produces the following output:

 C
     Coho Vineyard 89453312
     Contoso Pharmaceuticals 670053128
 L
     Lucerne Publishing 89112755
 W
     Wingtip Toys 299456122
     Wide World Importers 4665518773
*/

Remarques

La ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) méthode retourne un Lookup<TKey,TElement>dictionnaire un-à-plusieurs qui mappe des clés à des collections de valeurs. Un Lookup<TKey,TElement> diffère d’un Dictionary<TKey,TValue>, qui effectue un mappage un-à-un de clés à des valeurs uniques.

Le comparateur Default d’égalité par défaut est utilisé pour comparer les clés.

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)

Source:

Lookup.cs

Crée une Lookup<TKey,TElement> à partir de IEnumerable<T> selon une fonction de sélection de clé spécifiée, un comparateur et une fonction de sélection d'élément.

C#

public static System.Linq.ILookup<TKey,TElement> ToLookup<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

Paramètres de type

TSource

Le type des éléments de source.

TKey

Type de clé retournée par keySelector.

TElement

Type de la valeur retournée par elementSelector.

Paramètres

source

IEnumerable<TSource>

IEnumerable<T> à partir duquel créer un Lookup<TKey,TElement>.

keySelector

Func<TSource,TKey>

Fonction permettant d'extraire une clé de chaque élément.

elementSelector

Func<TSource,TElement>

Fonction de transformation permettant de produire une valeur d'élément de résultat à partir de chaque élément.

comparer

IEqualityComparer<TKey>

IEqualityComparer<T> pour comparer les clés.

Retours

ILookup<TKey,TElement>

Lookup<TKey,TElement> qui contient des valeurs de type TElement sélectionnées dans la séquence d’entrée.

Exceptions

ArgumentNullException

source ou keySelector ou elementSelector a la valeur null.

Remarques

La ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>) méthode retourne un Lookup<TKey,TElement>dictionnaire un-à-plusieurs qui mappe des clés à des collections de valeurs. Un Lookup<TKey,TElement> diffère d’un Dictionary<TKey,TValue>, qui effectue un mappage un-à-un de clés à des valeurs uniques.

Si comparer a la valeur null, le comparateur Default d’égalité par défaut est utilisé pour comparer les clés.

ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

Source:

Lookup.cs

Crée un Lookup<TKey,TElement> à partir de IEnumerable<T> selon une fonction de sélection de clé spécifiée et un comparateur de clé.

C#

public static System.Linq.ILookup<TKey,TSource> ToLookup<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

Paramètres de type

TSource

Le type des éléments de source.

TKey

Type de clé retournée par keySelector.

Paramètres

source

IEnumerable<TSource>

IEnumerable<T> à partir duquel créer un Lookup<TKey,TElement>.

keySelector

Func<TSource,TKey>

Fonction permettant d'extraire une clé de chaque élément.

comparer

IEqualityComparer<TKey>

IEqualityComparer<T> pour comparer les clés.

Retours

ILookup<TKey,TSource>

Lookup<TKey,TElement> qui contient des clés et des valeurs. Les valeurs de chaque groupe apparaissent dans le même ordre que dans source.

Exceptions

ArgumentNullException

source ou keySelector est null.

Remarques

La ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>) méthode retourne un Lookup<TKey,TElement>dictionnaire un-à-plusieurs qui mappe des clés à des collections de valeurs. Un Lookup<TKey,TElement> est différent d’un Dictionary<TKey,TValue>, qui effectue un mappage un-à-un de clés à des valeurs uniques.

Si comparer a la valeur null, le comparateur Default d’égalité par défaut est utilisé pour comparer les clés.

ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

Source:

Lookup.cs

Crée un Lookup<TKey,TElement> à partir d'un IEnumerable<T> selon une fonction de sélection de clé spécifiée.

C#

public static System.Linq.ILookup<TKey,TSource> ToLookup<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

Paramètres de type

TSource

Le type des éléments de source.

TKey

Type de clé retournée par keySelector.

Paramètres

source

IEnumerable<TSource>

IEnumerable<T> à partir duquel créer un Lookup<TKey,TElement>.

keySelector

Func<TSource,TKey>

Fonction permettant d'extraire une clé de chaque élément.

Retours

ILookup<TKey,TSource>

Lookup<TKey,TElement> qui contient des clés et des valeurs. Les valeurs de chaque groupe apparaissent dans le même ordre que dans source.

Exceptions

ArgumentNullException

source ou keySelector est null.

Remarques

La ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) méthode retourne un Lookup<TKey,TElement>dictionnaire un-à-plusieurs qui mappe des clés à des collections de valeurs. Un Lookup<TKey,TElement> diffère d’un Dictionary<TKey,TValue>, qui effectue un mappage un-à-un de clés à des valeurs uniques.

Le comparateur Default d’égalité par défaut est utilisé pour comparer les clés.