Enumerable.GroupJoin Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Устанавливает корреляцию между элементами двух последовательностей на основе равенства ключей и группирует результаты.

Перегрузки

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>, IEqualityComparer<TKey>)	Устанавливает корреляцию между элементами двух последовательностей на основе равенства ключей и группирует результаты. Для сравнения ключей используется указанный компаратор IEqualityComparer<T>.

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

Исходный код:

GroupJoin.cs

Устанавливает корреляцию между элементами двух последовательностей на основе равенства ключей и группирует результаты. Для сравнения ключей используется компаратор проверки на равенство по умолчанию.

C#

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);

Параметры типа

TOuter

Тип элементов первой последовательности.

TInner

Тип элементов второй последовательности.

TKey

Тип ключей, возвращаемых функциями селектора ключа.

TResult

Тип результирующих элементов.

Параметры

outer

IEnumerable<TOuter>

Первая последовательность для соединения.

inner

IEnumerable<TInner>

Последовательность, соединяемая с первой последовательностью.

outerKeySelector

Func<TOuter,TKey>

Функция, извлекающая ключ соединения из каждого элемента первой последовательности.

innerKeySelector

Func<TInner,TKey>

Функция, извлекающая ключ соединения из каждого элемента второй последовательности.

resultSelector

Func<TOuter,IEnumerable<TInner>,TResult>

Функция, создающая результирующий элемент для элемента первой последовательности и коллекции соответствующих элементов второй последовательности.

Возвращаемое значение

IEnumerable<TResult>

Объект IEnumerable<T>, который содержит элементы типа TResult, полученные в результате соединения двух последовательностей с группировкой.

Исключения

ArgumentNullException

Значение параметра outer, inner, outerKeySelector, innerKeySelector или resultSelector — null.

Примеры

В следующем примере кода показано, как использовать GroupJoin<TOuter,TInner,TKey,TResult>(IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,IEnumerable<TInner>, TResult>) для выполнения сгруппированного соединения в двух последовательностях.

C#

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

Комментарии

Этот метод реализуется с помощью отложенного выполнения. Немедленно возвращаемое значение — это объект, в котором хранятся все сведения, необходимые для выполнения действия. Запрос, представленный этим методом, не выполняется до тех пор, пока объект не будет перечислен либо путем вызова его GetEnumerator метода напрямую, либо с помощью foreach в C# или For Each в Visual Basic.

Компаратор Defaultравенства по умолчанию используется для хэширования и сравнения ключей.

GroupJoin создает иерархические результаты, что означает, что элементы из outer объединяются с коллекциями соответствующих элементов из inner. GroupJoin позволяет основывать результаты на целом наборе совпадений для каждого элемента outer.

Примечание

Если для данного элемента outerотсутствуют коррелированные элементы в inner , последовательность совпадений для этого элемента будет пустой, но по-прежнему будет отображаться в результатах.

Функция resultSelector вызывается только один раз для каждого outer элемента вместе с коллекцией всех inner элементов, соответствующих элементу outer . Это отличается от Join метода , в котором функция селектора результатов вызывается для пар, содержащих один элемент из outer и один элемент из inner.

GroupJoin сохраняет порядок элементов outer, а для каждого элемента объекта outer— порядок соответствующих элементов из inner.

Метод GroupJoin не имеет прямого эквивалента в традиционных терминах реляционных баз данных. Однако он реализует расширенный набор внутренних соединений и левых внешних соединений. Обе эти операции можно записать с точки зрения группового соединения. Дополнительные сведения см. в разделе Операции соединения.

В синтаксисе выражений join ... intoGroupJoinзапроса предложение (C#) или Group Join (Visual Basic) преобразуется в вызов .

См. также раздел

• Операции соединения (C#)
• Операции соединения (Visual Basic)
• Предложение join (Справочник по C#)
• Предложение Group Join (Visual Basic)

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

Исходный код:

GroupJoin.cs

Устанавливает корреляцию между элементами двух последовательностей на основе равенства ключей и группирует результаты. Для сравнения ключей используется указанный компаратор IEqualityComparer<T>.

C#

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);

Параметры типа

TOuter

Тип элементов первой последовательности.

TInner

Тип элементов второй последовательности.

TKey

Тип ключей, возвращаемых функциями селектора ключа.

TResult

Тип результирующих элементов.

Параметры

outer

IEnumerable<TOuter>

Первая последовательность для соединения.

inner

IEnumerable<TInner>

Последовательность, соединяемая с первой последовательностью.

outerKeySelector

Func<TOuter,TKey>

Функция, извлекающая ключ соединения из каждого элемента первой последовательности.

innerKeySelector

Func<TInner,TKey>

Функция, извлекающая ключ соединения из каждого элемента второй последовательности.

resultSelector

Func<TOuter,IEnumerable<TInner>,TResult>

Функция, создающая результирующий элемент для элемента первой последовательности и коллекции соответствующих элементов второй последовательности.

comparer

IEqualityComparer<TKey>

Компаратор IEqualityComparer<T>, используемый для хэширования и сравнения ключей.

Возвращаемое значение

IEnumerable<TResult>

Объект IEnumerable<T>, который содержит элементы типа TResult, полученные в результате соединения двух последовательностей с группировкой.

Исключения

ArgumentNullException

Значение параметра outer, inner, outerKeySelector, innerKeySelector или resultSelector — null.

Комментарии

Этот метод реализуется с помощью отложенного выполнения. Немедленно возвращаемое значение — это объект, в котором хранятся все сведения, необходимые для выполнения действия. Запрос, представленный этим методом, не выполняется до тех пор, пока объект не будет перечислен либо путем вызова его GetEnumerator метода напрямую, либо с помощью foreach в C# или For Each в Visual Basic.

Если comparer имеет значение null, то для хэширования и сравнения ключей используется средство сравнения Defaultна равенство по умолчанию.

GroupJoin создает иерархические результаты, что означает, что элементы из outer объединяются с коллекциями соответствующих элементов из inner. GroupJoin позволяет основывать результаты на целом наборе совпадений для каждого элемента outer.

Примечание

Если для данного элемента outerотсутствуют коррелированные элементы в inner , последовательность совпадений для этого элемента будет пустой, но по-прежнему будет отображаться в результатах.

Функция resultSelector вызывается только один раз для каждого outer элемента вместе с коллекцией всех inner элементов, соответствующих элементу outer . Это отличается от Join метода, в котором функция селектора результатов вызывается для пар, содержащих один элемент из outer и один элемент из inner.

GroupJoin сохраняет порядок элементов outer, а для каждого элемента объекта outer— порядок соответствующих элементов из inner.

Метод GroupJoin не имеет прямого эквивалента в традиционных терминах реляционных баз данных. Однако он реализует расширенный набор внутренних соединений и левых внешних соединений. Обе эти операции можно записать с точки зрения группового соединения. Дополнительные сведения см. в разделе Операции соединения.

См. также раздел

• Операции соединения (C#)
• Операции соединения (Visual Basic)