Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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

Establece la correlación de dos secuencias basándose en claves coincidentes. 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> Join<TOuter, TInner, TKey, TResult>(
	this IEnumerable<TOuter> outer,
	IEnumerable<TInner> inner,
	Func<TOuter, TKey> outerKeySelector,
	Func<TInner, TKey> innerKeySelector,
	Func<TOuter, TInner, TResult> resultSelector
)

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.

Parámetros

outer
Tipo: System.Collections.Generic.IEnumerable<TOuter>
Primera secuencia que se va a combinar.
inner
Tipo: System.Collections.Generic.IEnumerable<TInner>
Secuencia que se va a combinar con la primera secuencia.
outerKeySelector
Tipo: System.Func<TOuter, TKey>
Función para extraer la clave de combinación a partir de cada elemento de la primera secuencia.
innerKeySelector
Tipo: System.Func<TInner, TKey>
Función para extraer la clave de combinación a partir de cada elemento de la segunda secuencia.
resultSelector
Tipo: System.Func<TOuter, TInner, TResult>
Función que va a crear un elemento de resultado a partir de dos elementos coincidentes.

Valor devuelto

Tipo: System.Collections.Generic.IEnumerable<TResult>
Una interfaz IEnumerable<T> que tiene elementos de tipo TResult que se obtienen al realizar una combinación interna de dos secuencias.

Nota sobre el uso

En Visual Basic y C#, se puede llamar a este método como a un método de instancia en cualquier objeto de tipo IEnumerable<TOuter>. Cuando emplee la sintaxis del método de instancia para llamar a este método, omita el primer parámetro. Para obtener más información, vea Métodos de extensión (Visual Basic) o Métodos de extensión (Guía de programación de C#).

ExcepciónCondición
ArgumentNullException

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

Este método se implementa usando 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 mediante una llamada directa a su método GetEnumerator o a través de foreach en Visual C# o For Each en Visual Basic.

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

Una unión hace referencia a la operación de correlacionar elementos de dos fuentes de información basados en una clave común. Join trae las dos fuentes de información y las claves por las que coinciden en una llamada al método. Este uso es diferente al de SelectMany, que requiere varias llamadas al método para realizar la misma operación.

Join mantiene el orden de los elementos de outer, y en cada uno de estos elementos, mantiene el orden de los elementos coincidentes de inner.

En la sintaxis de las expresiones de consulta, una cláusula join (Visual C#) o Join (Visual Basic) se convierte en una invocación de Join.

En cuanto a las bases de datos relacionales, el método Join implementa una combinación de igualdad interna. 'Interna' significa que sólo los elementos que tienen una correspondencia en otra secuencia se incluyen en los resultados. Una 'combinación de igualdad' es una combinación en la que las claves se comparan para determinar si son iguales. Una operación de combinación externa izquierda no tiene ningún operador de consulta estándar dedicado, pero esta operación se puede realizar utilizando el método GroupJoin. Vea Operaciones de combinación.

En el ejemplo de código siguiente se muestra cómo se utiliza Join<TOuter, TInner, TKey, TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter, TKey>, Func<TInner, TKey>, Func<TOuter, TInner, TResult>) para realizar una combinación interna de dos secuencias en función de una clave común.


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

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

            public static void JoinEx1()
            {
                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 of Person-Pet pairs where 
                // each element is an anonymous type that contains a
                // Pet's name and the name of the Person that owns the Pet.
                var query =
                    people.Join(pets,
                                person => person,
                                pet => pet.Owner,
                                (person, pet) =>
                                    new { OwnerName = person.Name, Pet = pet.Name });

                foreach (var obj in query)
                {
                    Console.WriteLine(
                        "{0} - {1}",
                        obj.OwnerName,
                        obj.Pet);
                }
            }

            /*
             This code produces the following output:

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



.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft