Enumerable.ToLookup Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.dll

Crea un objeto Lookup<TKey,TElement> genérico a partir de un objeto IEnumerable<T>.

Sobrecargas

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	Crea un objeto Lookup<TKey,TElement> a partir de un objeto IEnumerable<T> según el selector de claves especificado y las funciones del selector de elementos.
ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Crea un objeto Lookup<TKey,TElement> a partir de un objeto IEnumerable<T> según una función del selector de claves, un comparador y una función del selector de elementos especificados.
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Crea un objeto Lookup<TKey,TElement> a partir de un objeto IEnumerable<T> según una función del selector de claves especificada y el comparador de claves.
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Crea una clase Lookup<TKey,TElement> a partir de una interfaz IEnumerable<T> según una función del selector de claves especificada.

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

Source:

Lookup.cs

Crea un objeto Lookup<TKey,TElement> a partir de un objeto IEnumerable<T> según el selector de claves especificado y las funciones del selector de elementos.

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);

Parámetros de tipo

TSource

Tipo de los elementos de source.

TKey

Tipo de la clave devuelta por keySelector.

TElement

Tipo de valor devuelto por elementSelector.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> a partir del cual se va a crear Lookup<TKey,TElement>.

keySelector

Func<TSource,TKey>

Función para extraer una clave a partir de cada elemento.

elementSelector

Func<TSource,TElement>

Función de transformación que va a generar un valor de elemento de resultado a partir de cada elemento.

Devoluciones

ILookup<TKey,TElement>

Lookup<TKey,TElement> que contiene valores de tipo TElement seleccionados en la secuencia de entrada.

Excepciones

ArgumentNullException

source o keySelector o elementSelector es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) para crear un Lookup<TKey,TElement> mediante una función de selector de teclas y una función de selector de elementos.

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

Comentarios

El ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) método devuelve un Lookup<TKey,TElement>, un diccionario de uno a varios que asigna claves a colecciones de valores. Es Lookup<TKey,TElement> diferente de un Dictionary<TKey,TValue>, que realiza una asignación uno a uno de claves a valores únicos.

El comparador Default de igualdad predeterminado se usa para comparar claves.

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

Source:

Lookup.cs

Crea un objeto Lookup<TKey,TElement> a partir de un objeto IEnumerable<T> según una función del selector de claves, un comparador y una función del selector de elementos especificados.

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);

Parámetros de tipo

TSource

Tipo de los elementos de source.

TKey

Tipo de la clave devuelta por keySelector.

TElement

Tipo de valor devuelto por elementSelector.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> a partir del cual se va a crear Lookup<TKey,TElement>.

keySelector

Func<TSource,TKey>

Función para extraer una clave a partir de cada elemento.

elementSelector

Func<TSource,TElement>

Función de transformación que va a generar un valor de elemento de resultado a partir de cada elemento.

comparer

IEqualityComparer<TKey>

IEqualityComparer<T> para comparar claves.

Devoluciones

ILookup<TKey,TElement>

Lookup<TKey,TElement> que contiene valores de tipo TElement seleccionados en la secuencia de entrada.

Excepciones

ArgumentNullException

source o keySelector o elementSelector es null.

Comentarios

El ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>) método devuelve un Lookup<TKey,TElement>, un diccionario de uno a varios que asigna claves a colecciones de valores. Es Lookup<TKey,TElement> diferente de un Dictionary<TKey,TValue>, que realiza una asignación uno a uno de claves a valores únicos.

Si comparer es null, el comparador Default de igualdad predeterminado se usa para comparar claves.

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

Source:

Lookup.cs

Crea un objeto Lookup<TKey,TElement> a partir de un objeto IEnumerable<T> según una función del selector de claves especificada y el comparador de claves.

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);

Parámetros de tipo

TSource

Tipo de los elementos de source.

TKey

Tipo de la clave devuelta por keySelector.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> a partir del cual se va a crear Lookup<TKey,TElement>.

keySelector

Func<TSource,TKey>

Función para extraer una clave a partir de cada elemento.

comparer

IEqualityComparer<TKey>

IEqualityComparer<T> para comparar claves.

Devoluciones

ILookup<TKey,TSource>

Lookup<TKey,TElement> que contiene claves y valores. Los valores de cada grupo están en el mismo orden que en source.

Excepciones

ArgumentNullException

source o keySelector es null.

Comentarios

El ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>) método devuelve un Lookup<TKey,TElement>, un diccionario de uno a varios que asigna claves a colecciones de valores. Es Lookup<TKey,TElement> diferente a un Dictionary<TKey,TValue>, que realiza una asignación uno a uno de claves a valores únicos.

Si comparer es null, el comparador Default de igualdad predeterminado se usa para comparar claves.

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

Source:

Lookup.cs

Crea una clase Lookup<TKey,TElement> a partir de una interfaz IEnumerable<T> según una función del selector de claves especificada.

C#

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

Parámetros de tipo

TSource

Tipo de los elementos de source.

TKey

Tipo de la clave devuelta por keySelector.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> a partir del cual se va a crear Lookup<TKey,TElement>.

keySelector

Func<TSource,TKey>

Función para extraer una clave a partir de cada elemento.

Devoluciones

ILookup<TKey,TSource>

Lookup<TKey,TElement> que contiene claves y valores. Los valores de cada grupo están en el mismo orden que en source.

Excepciones

ArgumentNullException

source o keySelector es null.

Comentarios

El ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) método devuelve un Lookup<TKey,TElement>, un diccionario de uno a varios que asigna claves a colecciones de valores. Es Lookup<TKey,TElement> diferente de un Dictionary<TKey,TValue>, que realiza una asignación uno a uno de claves a valores únicos.

El comparador Default de igualdad predeterminado se usa para comparar claves.