Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Enumerable.GroupJoin<TOuter, TInner, TKey, TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter, TKey>, Func<TInner, TKey>, Func<TOuter, IEnumerable<TInner>, TResult>)

 

Publicado: octubre de 2016

Correlaciona los elementos de dos secuencias basándose en la igualdad de claves y agrupa los resultados. El comparador de igualdad predeterminado se usa para comparar claves.

Espacio de nombres:   System.Linq
Ensamblado:  System.Core (en System.Core.dll)

public static IEnumerable<TResult> GroupJoin<TOuter, TInner, TKey, TResult>(
	this IEnumerable<TOuter> outer,
	IEnumerable<TInner> inner,
	Func<TOuter, TKey> outerKeySelector,
	Func<TInner, TKey> innerKeySelector,
	Func<TOuter, IEnumerable<TInner>, TResult> resultSelector
)

Parámetros

outer
Type: System.Collections.Generic.IEnumerable<TOuter>

Primera secuencia que se va a combinar.

inner
Type: System.Collections.Generic.IEnumerable<TInner>

Secuencia que se va a combinar con la primera secuencia.

outerKeySelector
Type: System.Func<TOuter, TKey>

Función para extraer la clave de combinación a partir de cada elemento de la primera secuencia.

innerKeySelector
Type: System.Func<TInner, TKey>

Función para extraer la clave de combinación a partir de cada elemento de la segunda secuencia.

resultSelector
Type: System.Func<TOuter, IEnumerable<TInner>, TResult>

Función para crear un elemento de resultado a partir de un elemento de la primera secuencia y una colección de elementos coincidentes de la segunda.

Valor devuelto

Type: System.Collections.Generic.IEnumerable<TResult>

Un IEnumerable<T> que contiene elementos del tipo TResult que se han obtenido al realizar una combinación agrupada de dos secuencias.

Parámetros de tipo

TOuter

Tipo de los elementos de la primera secuencia.

TInner

Tipo de los elementos de la segunda secuencia.

TKey

Tipo de las claves devueltas por las funciones del selector de claves.

TResult

Tipo de los elementos del resultado.

Exception Condition
ArgumentNullException

outer o inner o outerKeySelector o innerKeySelector o resultSelector es null.

Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que se enumera el objeto llamando a su GetEnumerator método directamente o mediante foreach en Visual C# o For Each en Visual Basic.

El comparador de igualdad predeterminado, Default, se utiliza para el algoritmo hash y comparar las claves.

GroupJoin<TOuter, TInner, TKey, TResult> genera resultados jerárquicos, lo que significa que los elementos de outer se emparejan con colecciones de elementos coincidentes de inner. GroupJoin permite basar los resultados en un conjunto completo de coincidencias para cada elemento de outer.

System_CAPS_noteNota

Si hay no hay elementos correlacionados en inner para un elemento determinado de outer, la secuencia de coincidencias para ese elemento estará vacía, pero seguirá apareciendo en los resultados.

El resultSelector se llama solo una vez para cada función outer elemento junto con una colección de todos los inner elementos que coinciden con la outer elemento. Esto difiere de la Join<TOuter, TInner, TKey, TResult> (método), en el que se invoca la función de selector de resultados en los pares que contienen un elemento de outer y un elemento de inner.

GroupJoin conserva el orden de los elementos de outer, y para cada elemento de outer, el orden de los elementos coincidentes de inner.

GroupJoin<TOuter, TInner, TKey, TResult> no tiene equivalente directo en términos de bases de datos relacionales tradicionales. Sin embargo, este método implementa un superconjunto de combinaciones internas y combinaciones externas izquierdas. Estas dos operaciones pueden escribirse en términos de una combinación agrupada. Consulta Join Operations.

En la sintaxis de expresión de consulta, un join … into (Visual C#) o Group Join (Visual Basic) cláusula se convierte en una invocación de GroupJoin<TOuter, TInner, TKey, TResult>.

En el ejemplo de código siguiente se muestra cómo utilizar GroupJoin<TOuter, TInner, TKey, TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter, TKey>, Func<TInner, TKey>, Func<TOuter, IEnumerable<TInner>, TResult>) para realizar una combinación agrupada de dos secuencias.

class Person
{
    public string Name { get; set; }
}

class Pet
{
    public string Name { get; set; }
    public Person Owner { get; set; }
}

public static void GroupJoinEx1()
{
    Person magnus = new Person { Name = "Hedlund, Magnus" };
    Person terry = new Person { Name = "Adams, Terry" };
    Person charlotte = new Person { Name = "Weiss, Charlotte" };

    Pet barley = new Pet { Name = "Barley", Owner = terry };
    Pet boots = new Pet { Name = "Boots", Owner = terry };
    Pet whiskers = new Pet { Name = "Whiskers", Owner = charlotte };
    Pet daisy = new Pet { Name = "Daisy", Owner = magnus };

    List<Person> people = new List<Person> { magnus, terry, charlotte };
    List<Pet> pets = new List<Pet> { barley, boots, whiskers, daisy };

    // Create a list where each element is an anonymous 
    // type that contains a person's name and 
    // a collection of names of the pets they own.
    var query =
        people.GroupJoin(pets,
                         person => person,
                         pet => pet.Owner,
                         (person, petCollection) =>
                             new
                             {
                                 OwnerName = person.Name,
                                 Pets = petCollection.Select(pet => pet.Name)
                             });

    foreach (var obj in query)
    {
        // Output the owner's name.
        Console.WriteLine("{0}:", obj.OwnerName);
        // Output each of the owner's pet's names.
        foreach (string pet in obj.Pets)
        {
            Console.WriteLine("  {0}", pet);
        }
    }
}

/*
 This code produces the following output:

 Hedlund, Magnus:
   Daisy
 Adams, Terry:
   Barley
   Boots
 Weiss, Charlotte:
   Whiskers
*/

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 3.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: