# Enumerable.GroupJoinEnumerable.GroupJoinEnumerable.GroupJoinEnumerable.GroupJoin Method

## 정의

키가 같은지 여부에 따라 두 시퀀스의 요소를 연관시키고 결과를 그룹화합니다.Correlates the elements of two sequences based on key equality, and groups the results.

## 오버로드

 GroupJoin(IEnumerable, IEnumerable, Func, Func, Func,TResult>, IEqualityComparer) GroupJoin(IEnumerable, IEnumerable, Func, Func, Func,TResult>, IEqualityComparer) GroupJoin(IEnumerable, IEnumerable, Func, Func, Func,TResult>, IEqualityComparer) GroupJoin(IEnumerable, IEnumerable, Func, Func, Func,TResult>, IEqualityComparer) 키가 같은지 여부에 따라 두 시퀀스의 요소를 연관시키고 결과를 그룹화합니다.Correlates the elements of two sequences based on key equality and groups the results. 지정된 IEqualityComparer를 사용하여 키를 비교합니다.A specified IEqualityComparer is used to compare keys. GroupJoin(IEnumerable, IEnumerable, Func, Func, Func,TResult>) GroupJoin(IEnumerable, IEnumerable, Func, Func, Func,TResult>) GroupJoin(IEnumerable, IEnumerable, Func, Func, Func,TResult>) GroupJoin(IEnumerable, IEnumerable, Func, Func, Func,TResult>) 키가 같은지 여부에 따라 두 시퀀스의 요소를 연관시키고 결과를 그룹화합니다.Correlates the elements of two sequences based on equality of keys and groups the results. 기본 같음 비교자를 사용하여 키를 비교합니다.The default equality comparer is used to compare keys.

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

키가 같은지 여부에 따라 두 시퀀스의 요소를 연관시키고 결과를 그룹화합니다.Correlates the elements of two sequences based on key equality and groups the results. 지정된 IEqualityComparer<T>를 사용하여 키를 비교합니다.A specified IEqualityComparer<T> is used to compare keys.

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

#### 형식 매개 변수

TOuter

첫 번째 시퀀스 요소의 형식입니다.The type of the elements of the first sequence.

TInner

두 번째 시퀀스 요소의 형식입니다.The type of the elements of the second sequence.

TKey

키 선택기 함수에서 반환하는 키의 형식입니다.The type of the keys returned by the key selector functions.

TResult

결과 요소의 형식입니다.The type of the result elements.

#### 매개 변수

outer
IEnumerable<TOuter>

조인할 첫 번째 시퀀스입니다.The first sequence to join.

inner
IEnumerable<TInner>

첫 번째 시퀀스에 조인할 시퀀스입니다.The sequence to join to the first sequence.

outerKeySelector
Func<TOuter,TKey>

첫 번째 시퀀스의 각 요소에서 조인 키를 추출하는 함수입니다.A function to extract the join key from each element of the first sequence.

innerKeySelector
Func<TInner,TKey>

두 번째 시퀀스의 각 요소에서 조인 키를 추출하는 함수입니다.A function to extract the join key from each element of the second sequence.

resultSelector
Func<TOuter,IEnumerable<TInner>,TResult>

첫 번째 시퀀스의 요소와 두 번째 시퀀스의 일치하는 요소 컬렉션을 통해 결과 요소를 만들 함수입니다.A function to create a result element from an element from the first sequence and a collection of matching elements from the second sequence.

comparer
IEqualityComparer<TKey>

키를 해시하여 비교할 IEqualityComparer<T>입니다.An IEqualityComparer<T> to hash and compare keys.

#### 반환

IEnumerable<TResult>

두 시퀀스에 대해 그룹화 조인을 수행하여 가져온 `TResult` 형식 요소가 들어 있는 IEnumerable<T>입니다.An IEnumerable<T> that contains elements of type `TResult` that are obtained by performing a grouped join on two sequences.

#### 예외

`outer`, `inner`, `outerKeySelector`, `innerKeySelector` 또는 `resultSelector``null`인 경우`outer` or `inner` or `outerKeySelector` or `innerKeySelector` or `resultSelector` is `null`.

### 설명

이 메서드는 지연 된 실행을 사용 하 여 구현 됩니다.This method is implemented by using deferred execution. 즉시 반환 값은 작업을 수행 하는 데 필요한 모든 정보를 저장 하는 개체입니다.The immediate return value is an object that stores all the information that is required to perform the action. 이 메서드를 나타내는 쿼리 하거나 호출 하 여 개체 열거 될 때까지 실행 되지 않습니다 해당 `GetEnumerator` 메서드를 사용 하 여 직접 또는 `foreach` Visual C# 또는 `For Each` Visual Basic의 합니다.The query represented by this method is not executed until the object is enumerated either by calling its `GetEnumerator` method directly or by using `foreach` in Visual C# or `For Each` in Visual Basic.

하는 경우 `comparer` 됩니다 `null`, 기본 같음 비교자를 Default, 해시 키를 비교 하는 데 사용 됩니다.If `comparer` is `null`, the default equality comparer, Default, is used to hash and compare keys.

GroupJoin 계층적 결과 생성의 요소 `outer` 일치 하는 요소 컬렉션 쌍을 이루는 `inner`합니다.GroupJoin produces hierarchical results, which means that elements from `outer` are paired with collections of matching elements from `inner`. `GroupJoin` 각 요소에 대 한 일치 항목의 전체 집합에서 결과를 사용 하면 `outer`합니다.`GroupJoin` enables you to base your results on a whole set of matches for each element of `outer`.

참고

상관 관계가 지정 된 요소가 없을 경우 `inner` 의 지정된 된 요소에 대 한 `outer`, 해당 요소에 대 한 일치 항목의 시퀀스 비어 있지만 결과에 계속 표시 됩니다.If there are no correlated elements in `inner` for a given element of `outer`, the sequence of matches for that element will be empty but will still appear in the results.

`resultSelector` 각각에 대해 한 번만 호출 될 `outer` 모든 컬렉션과 함께 요소는 `inner` 일치 하는 요소는 `outer` 요소입니다.The `resultSelector` function is called only one time for each `outer` element together with a collection of all the `inner` elements that match the `outer` element. 이 반해 합니다 Join 하나의 요소를 포함 하는 쌍의 결과 선택기 함수를 호출 하는 메서드 `outer` 한 요소와 `inner`합니다.This differs from the Join method in which the result selector function is invoked on pairs that contain one element from `outer` and one element from `inner`.

`GroupJoin` 요소의 순서를 유지 `outer`, 및의 각 요소에 대해 `outer`에서 일치 하는 요소의 순서 `inner`합니다.`GroupJoin` preserves the order of the elements of `outer`, and for each element of `outer`, the order of the matching elements from `inner`.

GroupJoin 기존 관계형 데이터베이스 용어에서 상응을 있습니다.GroupJoin has no direct equivalent in traditional relational database terms. 그러나이 메서드는 내부 조인 및 왼쪽된 우선 외부 조인의 상위 집합을 구현지 않습니다.However, this method does implement a superset of inner joins and left outer joins. 이러한 작업 모두 그룹화 조인을 기준으로 작성할 수 있습니다.Both of these operations can be written in terms of a grouped join. 참조 조인 작업합니다.See Join Operations.

추가 정보

## GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>,TResult>)GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>,TResult>)GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>,TResult>)GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>,TResult>)

키가 같은지 여부에 따라 두 시퀀스의 요소를 연관시키고 결과를 그룹화합니다.Correlates the elements of two sequences based on equality of keys and groups the results. 기본 같음 비교자를 사용하여 키를 비교합니다.The default equality comparer is used to compare keys.

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

#### 형식 매개 변수

TOuter

첫 번째 시퀀스 요소의 형식입니다.The type of the elements of the first sequence.

TInner

두 번째 시퀀스 요소의 형식입니다.The type of the elements of the second sequence.

TKey

키 선택기 함수에서 반환하는 키의 형식입니다.The type of the keys returned by the key selector functions.

TResult

결과 요소의 형식입니다.The type of the result elements.

#### 매개 변수

outer
IEnumerable<TOuter>

조인할 첫 번째 시퀀스입니다.The first sequence to join.

inner
IEnumerable<TInner>

첫 번째 시퀀스에 조인할 시퀀스입니다.The sequence to join to the first sequence.

outerKeySelector
Func<TOuter,TKey>

첫 번째 시퀀스의 각 요소에서 조인 키를 추출하는 함수입니다.A function to extract the join key from each element of the first sequence.

innerKeySelector
Func<TInner,TKey>

두 번째 시퀀스의 각 요소에서 조인 키를 추출하는 함수입니다.A function to extract the join key from each element of the second sequence.

resultSelector
Func<TOuter,IEnumerable<TInner>,TResult>

첫 번째 시퀀스의 요소와 두 번째 시퀀스의 일치하는 요소 컬렉션을 통해 결과 요소를 만들 함수입니다.A function to create a result element from an element from the first sequence and a collection of matching elements from the second sequence.

#### 반환

IEnumerable<TResult>

두 시퀀스에 대해 그룹화 조인을 수행하여 가져온 `TResult` 형식 요소가 들어 있는 IEnumerable<T>입니다.An IEnumerable<T> that contains elements of type `TResult` that are obtained by performing a grouped join on two sequences.

#### 예외

`outer`, `inner`, `outerKeySelector`, `innerKeySelector` 또는 `resultSelector``null`인 경우`outer` or `inner` or `outerKeySelector` or `innerKeySelector` or `resultSelector` is `null`.

### 예제

다음 코드 예제에 사용 하는 방법을 보여 줍니다. GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>,TResult>) 두 시퀀스에 대해 그룹화 조인을 수행 하 합니다.The following code example demonstrates how to use GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>,TResult>) to perform a grouped join on two sequences.

``````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
Barley
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 GroupJoinEx1()
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 collection where each element is an anonymous type
' that contains a Person's name and a collection of names of
' the pets that are owned by them.
Dim query =
people.GroupJoin(pets,
Function(person) person,
Function(pet) pet.Owner,
Function(person, petCollection) _
New With {.OwnerName = person.Name,
.Pets = petCollection.Select(
Function(pet) pet.Name)})

Dim output As New System.Text.StringBuilder
For Each obj In query
' Output the owner's name.
output.AppendLine(obj.OwnerName & ":")
' Output each of the owner's pet's names.
For Each pet As String In obj.Pets
output.AppendLine("  " & pet)
Next
Next

' Display the output.
MsgBox(output.ToString)
End Sub

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

### 설명

이 메서드는 지연 된 실행을 사용 하 여 구현 됩니다.This method is implemented by using deferred execution. 즉시 반환 값은 작업을 수행 하는 데 필요한 모든 정보를 저장 하는 개체입니다.The immediate return value is an object that stores all the information that is required to perform the action. 이 메서드를 나타내는 쿼리 하거나 호출 하 여 개체 열거 될 때까지 실행 되지 않습니다 해당 `GetEnumerator` 메서드를 사용 하 여 직접 또는 `foreach` Visual C# 또는 `For Each` Visual Basic의 합니다.The query represented by this method is not executed until the object is enumerated either by calling its `GetEnumerator` method directly or by using `foreach` in Visual C# or `For Each` in Visual Basic.

기본 같음 비교자를 Default, 해시 키를 비교 하는 데 사용 됩니다.The default equality comparer, Default, is used to hash and compare keys.

GroupJoin 계층적 결과 생성의 요소 `outer` 일치 하는 요소 컬렉션 쌍을 이루는 `inner`합니다.GroupJoin produces hierarchical results, which means that elements from `outer` are paired with collections of matching elements from `inner`. `GroupJoin` 각 요소에 대 한 일치 항목의 전체 집합에서 결과를 사용 하면 `outer`합니다.`GroupJoin` enables you to base your results on a whole set of matches for each element of `outer`.

참고

상관 관계가 지정 된 요소가 없을 경우 `inner` 의 지정된 된 요소에 대 한 `outer`, 해당 요소에 대 한 일치 항목의 시퀀스 비어 있지만 결과에 계속 표시 됩니다.If there are no correlated elements in `inner` for a given element of `outer`, the sequence of matches for that element will be empty but will still appear in the results.

`resultSelector` 각각에 대해 한 번만 호출 될 `outer` 모든 컬렉션과 함께 요소는 `inner` 일치 하는 요소는 `outer` 요소입니다.The `resultSelector` function is called only one time for each `outer` element together with a collection of all the `inner` elements that match the `outer` element. 이 반해 합니다 Join 메서드를 한 요소를 포함 하는 쌍의 결과 선택기 함수를 호출 하는 `outer` 한 요소와 `inner`합니다.This differs from the Join method, in which the result selector function is invoked on pairs that contain one element from `outer` and one element from `inner`.

`GroupJoin` 요소의 순서를 유지 `outer`, 및의 각 요소에 대해 `outer`에서 일치 하는 요소의 순서 `inner`합니다.`GroupJoin` preserves the order of the elements of `outer`, and for each element of `outer`, the order of the matching elements from `inner`.

GroupJoin 기존 관계형 데이터베이스 용어에서 상응을 있습니다.GroupJoin has no direct equivalent in traditional relational database terms. 그러나이 메서드는 내부 조인 및 왼쪽된 우선 외부 조인의 상위 집합을 구현지 않습니다.However, this method does implement a superset of inner joins and left outer joins. 이러한 작업 모두 그룹화 조인을 기준으로 작성할 수 있습니다.Both of these operations can be written in terms of a grouped join. 참조 조인 작업합니다.See Join Operations.

쿼리 식 구문에는 `join … into` (Visual C#) 또는 `Group Join` 절 (Visual Basic)의 호출으로 변환 GroupJoin합니다.In query expression syntax, a `join … into` (Visual C#) or `Group Join` (Visual Basic) clause translates to an invocation of GroupJoin.

추가 정보