Enumerable.ToLookup Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Cria um Lookup<TKey,TElement> genérico de um IEnumerable<T>.

Sobrecargas

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	Cria um Lookup<TKey,TElement> de um IEnumerable<T>, de acordo com as funções especificadas de seletor de chave e seletor de elemento.
ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Cria um Lookup<TKey,TElement> de um IEnumerable<T> de acordo com uma função de seletor de chave, um comparador e uma função de seletor de elemento especificados.
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Cria um Lookup<TKey,TElement> de um IEnumerable<T>, de acordo com uma função de seletor de chave especificada e um comparador de chaves.
ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Cria um Lookup<TKey,TElement> de um IEnumerable<T>, de acordo com uma função de seletor de chave especificada.

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

Origem:

Lookup.cs

Cria um Lookup<TKey,TElement> de um IEnumerable<T>, de acordo com as funções especificadas de seletor de chave e seletor de elemento.

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

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

TElement

O tipo do valor retornado por elementSelector.

Parâmetros

source

IEnumerable<TSource>

O IEnumerable<T> por meio do qual um Lookup<TKey,TElement> será criado.

keySelector

Func<TSource,TKey>

Uma função para extrair uma chave de cada elemento.

elementSelector

Func<TSource,TElement>

Uma função de transformação para produzir um valor de elemento de resultado de cada elemento.

Retornos

ILookup<TKey,TElement>

Um Lookup<TKey,TElement> que contém valores do tipo TElement selecionados da sequência de entrada.

Exceções

ArgumentNullException

source, keySelector ou elementSelector é null.

Exemplos

O exemplo de código a seguir demonstra como usar ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) para criar um Lookup<TKey,TElement> usando uma função seletora de chave e uma função seletora de elemento.

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

Comentários

O ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) método retorna um Lookup<TKey,TElement>, um dicionário de um para muitos que mapeia chaves para coleções de valores. Um Lookup<TKey,TElement> difere de um Dictionary<TKey,TValue>, que executa um mapeamento um-para-um de chaves para valores únicos.

O comparador Default de igualdade padrão é usado para comparar chaves.

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

Origem:

Lookup.cs

Cria um Lookup<TKey,TElement> de um IEnumerable<T> de acordo com uma função de seletor de chave, um comparador e uma função de seletor de elemento 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

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

TElement

O tipo do valor retornado por elementSelector.

Parâmetros

source

IEnumerable<TSource>

O IEnumerable<T> por meio do qual um Lookup<TKey,TElement> será criado.

keySelector

Func<TSource,TKey>

Uma função para extrair uma chave de cada elemento.

elementSelector

Func<TSource,TElement>

Uma função de transformação para produzir um valor de elemento de resultado de cada elemento.

comparer

IEqualityComparer<TKey>

Um IEqualityComparer<T> para comparar chaves.

Retornos

ILookup<TKey,TElement>

Um Lookup<TKey,TElement> que contém valores do tipo TElement selecionados da sequência de entrada.

Exceções

ArgumentNullException

source, keySelector ou elementSelector é null.

Comentários

O ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>) método retorna um Lookup<TKey,TElement>, um dicionário de um para muitos que mapeia chaves para coleções de valores. Um Lookup<TKey,TElement> difere de um Dictionary<TKey,TValue>, que executa um mapeamento um-para-um de chaves para valores únicos.

Se comparer for null, o comparador Default de igualdade padrão será usado para comparar chaves.

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

Origem:

Lookup.cs

Cria um Lookup<TKey,TElement> de um IEnumerable<T>, de acordo com uma função de seletor de chave especificada e um comparador de chaves.

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

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

Parâmetros

source

IEnumerable<TSource>

O IEnumerable<T> por meio do qual um Lookup<TKey,TElement> será criado.

keySelector

Func<TSource,TKey>

Uma função para extrair uma chave de cada elemento.

comparer

IEqualityComparer<TKey>

Um IEqualityComparer<T> para comparar chaves.

Retornos

ILookup<TKey,TSource>

Um Lookup<TKey,TElement> que contém chaves e valores. Os valores dentro de cada grupo estão na mesma ordem que no source.

Exceções

ArgumentNullException

source ou keySelector é null.

Comentários

O ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>) método retorna um Lookup<TKey,TElement>, um dicionário de um para muitos que mapeia chaves para coleções de valores. Um Lookup<TKey,TElement> é diferente de um Dictionary<TKey,TValue>, que executa um mapeamento um-para-um de chaves para valores únicos.

Se comparer for null, o comparador Default de igualdade padrão será usado para comparar chaves.

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

Origem:

Lookup.cs

Cria um Lookup<TKey,TElement> de um IEnumerable<T>, de acordo com uma função de seletor de chave 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

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

Parâmetros

source

IEnumerable<TSource>

O IEnumerable<T> por meio do qual um Lookup<TKey,TElement> será criado.

keySelector

Func<TSource,TKey>

Uma função para extrair uma chave de cada elemento.

Retornos

ILookup<TKey,TSource>

Um Lookup<TKey,TElement> que contém chaves e valores. Os valores dentro de cada grupo estão na mesma ordem que no source.

Exceções

ArgumentNullException

source ou keySelector é null.

Comentários

O ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) método retorna um Lookup<TKey,TElement>, um dicionário de um para muitos que mapeia chaves para coleções de valores. Um Lookup<TKey,TElement> difere de um Dictionary<TKey,TValue>, que executa um mapeamento um-para-um de chaves para valores únicos.

O comparador Default de igualdade padrão é usado para comparar chaves.