Enumerable.Join Método

Definição

Correlaciona os elementos de duas sequências com base em chaves de correspondência.

Sobrecargas

Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>)

Correlaciona os elementos de duas sequências com base em chaves de correspondência. O comparador de igualdade padrão é usado para comparar chaves.

Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>, IEqualityComparer<TKey>)

Correlaciona os elementos de duas sequências com base em chaves de correspondência. Um IEqualityComparer<T> especificado é usado para comparar chaves.

Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>)

Correlaciona os elementos de duas sequências com base em chaves de correspondência. O comparador de igualdade padrão é usado para comparar chaves.

public:
generic <typename TOuter, typename TInner, typename TKey, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TResult> ^ Join(System::Collections::Generic::IEnumerable<TOuter> ^ outer, System::Collections::Generic::IEnumerable<TInner> ^ inner, Func<TOuter, TKey> ^ outerKeySelector, Func<TInner, TKey> ^ innerKeySelector, Func<TOuter, TInner, TResult> ^ resultSelector);
public static System.Collections.Generic.IEnumerable<TResult> Join<TOuter,TInner,TKey,TResult> (this System.Collections.Generic.IEnumerable<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, Func<TOuter,TKey> outerKeySelector, Func<TInner,TKey> innerKeySelector, Func<TOuter,TInner,TResult> resultSelector);
static member Join : seq<'Outer> * seq<'Inner> * Func<'Outer, 'Key> * Func<'Inner, 'Key> * Func<'Outer, 'Inner, 'Result> -> seq<'Result>
<Extension()>
Public Function Join(Of TOuter, TInner, TKey, TResult) (outer As IEnumerable(Of TOuter), inner As IEnumerable(Of TInner), outerKeySelector As Func(Of TOuter, TKey), innerKeySelector As Func(Of TInner, TKey), resultSelector As Func(Of TOuter, TInner, TResult)) As IEnumerable(Of TResult)

Parâmetros de tipo

TOuter

O tipo dos elementos da primeira sequência.

TInner

O tipo dos elementos da segunda sequência.

TKey

O tipo das chaves retornadas pelas funções de seletor de chave.

TResult

O tipo dos elementos de resultado.

Parâmetros

outer
IEnumerable<TOuter>

A primeira sequência a ser ingressada.

inner
IEnumerable<TInner>

A sequência a ser ingressada à primeira sequência.

outerKeySelector
Func<TOuter,TKey>

Uma função para extrair a chave de junção de cada elemento da primeira sequência.

innerKeySelector
Func<TInner,TKey>

Uma função para extrair a chave de junção de cada elemento da segunda sequência.

resultSelector
Func<TOuter,TInner,TResult>

Uma função para criar um elemento de resultado de dois elementos correspondentes.

Retornos

IEnumerable<TResult>

Um IEnumerable<T> com elementos do tipo TResult obtidos pela execução de uma junção interna em duas sequências.

Exceções

outer ou inner ou outerKeySelector ou innerKeySelector ou resultSelector é null.

Exemplos

O exemplo de código a seguir demonstra como usar Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>) para executar uma junção interna de duas sequências com base em uma chave comum.

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
*/
Structure Person
    Public Name As String
End Structure

Structure Pet
    Public Name As String
    Public Owner As Person
End Structure

Sub JoinEx1()
    Dim magnus As New Person With {.Name = "Hedlund, Magnus"}
    Dim terry As New Person With {.Name = "Adams, Terry"}
    Dim charlotte As New Person With {.Name = "Weiss, Charlotte"}

    Dim barley As New Pet With {.Name = "Barley", .Owner = terry}
    Dim boots As New Pet With {.Name = "Boots", .Owner = terry}
    Dim whiskers As New Pet With {.Name = "Whiskers", .Owner = charlotte}
    Dim daisy As New Pet With {.Name = "Daisy", .Owner = magnus}

    Dim people As New List(Of Person)(New Person() {magnus, terry, charlotte})
    Dim pets As New List(Of Pet)(New 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.
    Dim query =
people.Join(pets,
            Function(person) person,
            Function(pet) pet.Owner,
            Function(person, pet) _
                New With {.OwnerName = person.Name, .Pet = pet.Name})

    Dim output As New System.Text.StringBuilder
    For Each obj In query
        output.AppendLine(obj.OwnerName & " - " & obj.Pet)
    Next

    ' Display the output.
    Console.WriteLine(output.ToString)
End Sub

' This code produces the following output:
'
' Hedlund, Magnus - Daisy
' Adams, Terry - Barley
' Adams, Terry - Boots
' Weiss, Charlotte - Whiskers

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

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

Uma junção refere-se à operação de correlacionar os elementos de duas fontes de informações com base em uma chave comum. Join traz as duas fontes de informação e as chaves pelas quais elas são correspondidas em uma chamada de método. Isso difere do uso de , que requer mais de SelectManyuma chamada de método para executar a mesma operação.

Join preserva a ordem dos elementos de outere para cada um desses elementos, a ordem dos elementos correspondentes de inner.

Na sintaxe da expressão de consulta, uma join cláusula (C#) ou Join (Visual Basic) é convertida em uma invocação de Join.

Em termos de banco de dados relacional, o Join método implementa um equijoin interno. 'Inner' significa que apenas os elementos que têm uma correspondência na outra sequência são incluídos nos resultados. Um 'equijoin' é uma junção na qual as chaves são comparadas quanto à igualdade. Uma operação de junção externa à esquerda não tem nenhum operador de consulta padrão dedicado, mas pode ser executada usando o GroupJoin método . Para obter mais informações, consulte Operações de junção.

Confira também

Aplica-se a

Join<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>, IEqualityComparer<TKey>)

Correlaciona os elementos de duas sequências com base em chaves de correspondência. Um IEqualityComparer<T> especificado é usado para comparar chaves.

public:
generic <typename TOuter, typename TInner, typename TKey, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TResult> ^ Join(System::Collections::Generic::IEnumerable<TOuter> ^ outer, System::Collections::Generic::IEnumerable<TInner> ^ inner, Func<TOuter, TKey> ^ outerKeySelector, Func<TInner, TKey> ^ innerKeySelector, Func<TOuter, TInner, TResult> ^ resultSelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public static System.Collections.Generic.IEnumerable<TResult> Join<TOuter,TInner,TKey,TResult> (this System.Collections.Generic.IEnumerable<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, Func<TOuter,TKey> outerKeySelector, Func<TInner,TKey> innerKeySelector, Func<TOuter,TInner,TResult> resultSelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public static System.Collections.Generic.IEnumerable<TResult> Join<TOuter,TInner,TKey,TResult> (this System.Collections.Generic.IEnumerable<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, Func<TOuter,TKey> outerKeySelector, Func<TInner,TKey> innerKeySelector, Func<TOuter,TInner,TResult> resultSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);
static member Join : seq<'Outer> * seq<'Inner> * Func<'Outer, 'Key> * Func<'Inner, 'Key> * Func<'Outer, 'Inner, 'Result> * System.Collections.Generic.IEqualityComparer<'Key> -> seq<'Result>
<Extension()>
Public Function Join(Of TOuter, TInner, TKey, TResult) (outer As IEnumerable(Of TOuter), inner As IEnumerable(Of TInner), outerKeySelector As Func(Of TOuter, TKey), innerKeySelector As Func(Of TInner, TKey), resultSelector As Func(Of TOuter, TInner, TResult), comparer As IEqualityComparer(Of TKey)) As IEnumerable(Of TResult)

Parâmetros de tipo

TOuter

O tipo dos elementos da primeira sequência.

TInner

O tipo dos elementos da segunda sequência.

TKey

O tipo das chaves retornadas pelas funções de seletor de chave.

TResult

O tipo dos elementos de resultado.

Parâmetros

outer
IEnumerable<TOuter>

A primeira sequência a ser ingressada.

inner
IEnumerable<TInner>

A sequência a ser ingressada à primeira sequência.

outerKeySelector
Func<TOuter,TKey>

Uma função para extrair a chave de junção de cada elemento da primeira sequência.

innerKeySelector
Func<TInner,TKey>

Uma função para extrair a chave de junção de cada elemento da segunda sequência.

resultSelector
Func<TOuter,TInner,TResult>

Uma função para criar um elemento de resultado de dois elementos correspondentes.

comparer
IEqualityComparer<TKey>

Um IEqualityComparer<T> para executar hash e comparar chaves.

Retornos

IEnumerable<TResult>

Um IEnumerable<T> com elementos do tipo TResult obtidos pela execução de uma junção interna em duas sequências.

Exceções

outer ou inner ou outerKeySelector ou innerKeySelector ou resultSelector é null.

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

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

Uma junção refere-se à operação de correlacionar os elementos de duas fontes de informações com base em uma chave comum. Join traz as duas fontes de informação e as chaves pelas quais elas são correspondidas em uma chamada de método. Isso difere do uso de , que requer mais de SelectManyuma chamada de método para executar a mesma operação.

Join preserva a ordem dos elementos de outere para cada um desses elementos, a ordem dos elementos correspondentes de inner.

Em termos de banco de dados relacional, o Join método implementa um equijoin interno. 'Inner' significa que apenas os elementos que têm uma correspondência na outra sequência são incluídos nos resultados. Um 'equijoin' é uma junção na qual as chaves são comparadas quanto à igualdade. Uma operação de junção externa à esquerda não tem nenhum operador de consulta padrão dedicado, mas pode ser executada usando o GroupJoin método . Para obter mais informações, consulte Operações de junção.

Confira também

Aplica-se a