Queryable.GroupJoin 方法

定义

命名空间:

System.Linq

程序集:

System.Linq.Queryable.dll

基于键值等同性对两个序列的元素进行关联，并对结果进行分组。

重载

GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>)	基于键值等同性对两个序列的元素进行关联，并对结果进行分组。 使用默认的相等比较器对键进行比较。
GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>)	基于键值等同性对两个序列的元素进行关联，并对结果进行分组。 使用指定的 IEqualityComparer<T> 对键进行比较。

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

Source:

Queryable.cs

基于键值等同性对两个序列的元素进行关联，并对结果进行分组。 使用默认的相等比较器对键进行比较。

C#

public static System.Linq.IQueryable<TResult> GroupJoin<TOuter,TInner,TKey,TResult> (this System.Linq.IQueryable<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, System.Linq.Expressions.Expression<Func<TOuter,TKey>> outerKeySelector, System.Linq.Expressions.Expression<Func<TInner,TKey>> innerKeySelector, System.Linq.Expressions.Expression<Func<TOuter,System.Collections.Generic.IEnumerable<TInner>,TResult>> resultSelector);

类型参数

TOuter

第一个序列中的元素的类型。

TInner

第二个序列中的元素的类型。

TKey

键选择器函数返回的键的类型。

TResult

结果元素的类型。

参数

outer

IQueryable<TOuter>

要联接的第一个序列。

inner

IEnumerable<TInner>

要与第一个序列联接的序列。

outerKeySelector

Expression<Func<TOuter,TKey>>

用于从第一个序列的每个元素提取联接键的函数。

innerKeySelector

Expression<Func<TInner,TKey>>

用于从第二个序列的每个元素提取联接键的函数。

resultSelector

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

用于从第一个序列的元素和第二个序列的匹配元素集合中创建结果元素的函数。

返回

IQueryable<TResult>

一个 IQueryable<T>，包含通过对两个序列执行已分组的联接而获得的 TResult 类型的元素。

例外

ArgumentNullException

outer 或 inner 或 outerKeySelector 或 innerKeySelector 或 resultSelector 为 null。

示例

下面的代码示例演示如何使用 GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<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 that are owned by them.
    var query =
        people.AsQueryable().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
*/

注解

此方法至少有一个类型 Expression<TDelegate> 参数，其类型参数是类型之 Func<T,TResult> 一。 对于这些参数，可以传入 lambda 表达式，它将编译为 Expression<TDelegate>。

方法 GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>) 生成一个 ， MethodCallExpression 它将调用 GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>) 自身表示为构造的泛型方法。 然后，MethodCallExpressionCreateQuery<TElement>(Expression)它将 传递给 由 Provider 参数的 属性表示的 的 outer 方法IQueryProvider。

由于执行表示调用 GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>) 的表达式树而发生的查询行为取决于参数类型的 outer 实现。 预期的行为是 outerKeySelector ， 和 innerKeySelector 函数分别用于从 outer 和 inner中提取密钥。 比较这些键的相等性，以匹配 中 outer 具有零个或多个元素的每个元素 inner。 然后调用 函数 resultSelector ，从每组相关元素中投影结果对象。

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

Source:

Queryable.cs

基于键值等同性对两个序列的元素进行关联，并对结果进行分组。 使用指定的 IEqualityComparer<T> 对键进行比较。

C#

public static System.Linq.IQueryable<TResult> GroupJoin<TOuter,TInner,TKey,TResult> (this System.Linq.IQueryable<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, System.Linq.Expressions.Expression<Func<TOuter,TKey>> outerKeySelector, System.Linq.Expressions.Expression<Func<TInner,TKey>> innerKeySelector, System.Linq.Expressions.Expression<Func<TOuter,System.Collections.Generic.IEnumerable<TInner>,TResult>> resultSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

类型参数

TOuter

第一个序列中的元素的类型。

TInner

第二个序列中的元素的类型。

TKey

键选择器函数返回的键的类型。

TResult

结果元素的类型。

参数

outer

IQueryable<TOuter>

要联接的第一个序列。

inner

IEnumerable<TInner>

要与第一个序列联接的序列。

outerKeySelector

Expression<Func<TOuter,TKey>>

用于从第一个序列的每个元素提取联接键的函数。

innerKeySelector

Expression<Func<TInner,TKey>>

用于从第二个序列的每个元素提取联接键的函数。

resultSelector

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

用于从第一个序列的元素和第二个序列的匹配元素集合中创建结果元素的函数。

comparer

IEqualityComparer<TKey>

用于对键进行哈希处理和比较的比较器。

返回

IQueryable<TResult>

一个 IQueryable<T>，包含通过对两个序列执行已分组的联接而获得的 TResult 类型的元素。

例外

ArgumentNullException

outer 或 inner 或 outerKeySelector 或 innerKeySelector 或 resultSelector 为 null。

注解

此方法至少有一个类型 Expression<TDelegate> 参数，其类型参数是类型之 Func<T,TResult> 一。 对于这些参数，可以传入 lambda 表达式，它将编译为 Expression<TDelegate>。

方法 GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>) 生成一个 ， MethodCallExpression 它将调用 GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>) 自身表示为构造的泛型方法。 然后，MethodCallExpressionCreateQuery<TElement>(Expression)它将 传递给 由 Provider 参数的 属性表示的 的 outer 方法IQueryProvider。

由于执行表示调用 GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>) 的表达式树而发生的查询行为取决于参数类型的 outer 实现。 预期的行为是 outerKeySelector ， 和 innerKeySelector 函数分别用于从 outer 和 inner中提取密钥。 通过使用 comparer比较这些键的相等性。 比较的结果用于将 中的每个元素与 中的outerinner零个或多个元素进行匹配。 然后调用 函数 resultSelector ，从每组相关元素中投影结果对象。