Queryable.GroupBy Метод
Определение
Группирует элементы последовательности.Groups the elements of a sequence.
Перегрузки
GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>, IEqualityComparer<TKey>) |
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и создает результирующее значение для каждой группы и ее ключа.Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Ключи сравниваются с помощью указанного компаратора, элементы каждой группы проецируются с помощью указанной функции.Keys are compared by using a specified comparer and the elements of each group are projected by using a specified function. |
GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>) |
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и создает результирующее значение для каждой группы и ее ключа.Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Элементы каждой группы проецируются с помощью указанной функции.The elements of each group are projected by using a specified function. |
GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>) |
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и проецирует элементы каждой группы с помощью указанной функции.Groups the elements of a sequence according to a specified key selector function and projects the elements for each group by using a specified function. |
GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, IEqualityComparer<TKey>) |
Группирует элементы последовательности и проецирует элементы каждой группы с помощью указанной функции.Groups the elements of a sequence and projects the elements for each group by using a specified function. Значения ключей сравниваются с использованием заданного компаратора.Key values are compared by using a specified comparer. |
GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>) |
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и создает результирующее значение для каждой группы и ее ключа.Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. |
GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>, IEqualityComparer<TKey>) |
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и создает результирующее значение для каждой группы и ее ключа.Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Ключи сравниваются с использованием заданного компаратора.Keys are compared by using a specified comparer. |
GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IEqualityComparer<TKey>) |
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и сравнивает ключи с помощью указанного компаратора.Groups the elements of a sequence according to a specified key selector function and compares the keys by using a specified comparer. |
GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) |
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа.Groups the elements of a sequence according to a specified key selector function. |
GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>, IEqualityComparer<TKey>)
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и создает результирующее значение для каждой группы и ее ключа.Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Ключи сравниваются с помощью указанного компаратора, элементы каждой группы проецируются с помощью указанной функции.Keys are compared by using a specified comparer and the elements of each group are projected by using a specified function.
public:
generic <typename TSource, typename TKey, typename TElement, typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<TResult> ^ GroupBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector, System::Linq::Expressions::Expression<Func<TSource, TElement> ^> ^ elementSelector, System::Linq::Expressions::Expression<Func<TKey, System::Collections::Generic::IEnumerable<TElement> ^, TResult> ^> ^ resultSelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public static System.Linq.IQueryable<TResult> GroupBy<TSource,TKey,TElement,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TSource,TElement>> elementSelector, System.Linq.Expressions.Expression<Func<TKey,System.Collections.Generic.IEnumerable<TElement>,TResult>> resultSelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public static System.Linq.IQueryable<TResult> GroupBy<TSource,TKey,TElement,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TSource,TElement>> elementSelector, System.Linq.Expressions.Expression<Func<TKey,System.Collections.Generic.IEnumerable<TElement>,TResult>> resultSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);
static member GroupBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Linq.Expressions.Expression<Func<'Source, 'Element>> * System.Linq.Expressions.Expression<Func<'Key, seq<'Element>, 'Result>> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function GroupBy(Of TSource, TKey, TElement, TResult) (source As IQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey)), elementSelector As Expression(Of Func(Of TSource, TElement)), resultSelector As Expression(Of Func(Of TKey, IEnumerable(Of TElement), TResult)), comparer As IEqualityComparer(Of TKey)) As IQueryable(Of TResult)
Параметры типа
- TSource
Тип элементов source
.The type of the elements of source
.
- TKey
Тип ключа, возвращаемого функцией, заданной параметром keySelector
.The type of the key returned by the function represented in keySelector
.
- TElement
Тип элементов каждого объекта IGrouping<TKey,TElement>.The type of the elements in each IGrouping<TKey,TElement>.
- TResult
Тип результирующего значения, возвращаемого функцией resultSelector
.The type of the result value returned by resultSelector
.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, элементы которого следует сгруппировать.An IQueryable<T> whose elements to group.
- keySelector
- Expression<Func<TSource,TKey>>
Функция, извлекающая ключ для каждого элемента.A function to extract the key for each element.
- elementSelector
- Expression<Func<TSource,TElement>>
Функция, сопоставляющая каждый исходный элемент с элементом объекта IGrouping<TKey,TElement>.A function to map each source element to an element in an IGrouping<TKey,TElement>.
- resultSelector
- Expression<Func<TKey,IEnumerable<TElement>,TResult>>
Функция для создания результирующего значения для каждой группы.A function to create a result value from each group.
- comparer
- IEqualityComparer<TKey>
Компаратор IEqualityComparer<T>, используемый для сравнения ключей.An IEqualityComparer<T> to compare keys.
Возвращаемое значение
- IQueryable<TResult>
Объект T:System.Linq.IQueryable`1
с аргументом типа TResult
, каждый элемент которого представляет проекцию группы и ее ключа.An T:System.Linq.IQueryable`1
that has a type argument of TResult
and where each element represents a projection over a group and its key.
Исключения
Значение параметра source
, keySelector
, elementSelector
, resultSelector
или comparer
— null
.source
or keySelector
or elementSelector
or resultSelector
or comparer
is null
.
Комментарии
Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.
GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>, IEqualityComparer<TKey>)Метод создает объект MethodCallExpression , который представляет вызов GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>, IEqualityComparer<TKey>) самого себя как сконструированного универсального метода.The GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>, IEqualityComparer<TKey>) method generates a MethodCallExpression that represents calling GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>, IEqualityComparer<TKey>) itself as a constructed generic method. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source
параметра.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source
parameter.
Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>, IEqualityComparer<TKey>) зависит от реализации типа source
параметра.The query behavior that occurs as a result of executing an expression tree that represents calling GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>, IEqualityComparer<TKey>) depends on the implementation of the type of the source
parameter. Ожидаемое поведение заключается в том, что он группирует элементы source
по ключевым значениям, получаемым путем вызова keySelector
для каждого элемента.The expected behavior is that it groups the elements of source
by key values that are obtained by invoking keySelector
on each element. comparer
Параметр используется для сравнения значений ключей.The comparer
parameter is used to compare key values. elementSelector
Параметр используется для проецирования элементов каждой группы, а resultSelector
параметр используется для получения результирующего значения из каждой группы и ее ключа.The elementSelector
parameter is used to project the elements of each group, and the resultSelector
parameter is used to obtain a result value from each group and its key.
Применяется к
GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>)
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и создает результирующее значение для каждой группы и ее ключа.Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Элементы каждой группы проецируются с помощью указанной функции.The elements of each group are projected by using a specified function.
public:
generic <typename TSource, typename TKey, typename TElement, typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<TResult> ^ GroupBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector, System::Linq::Expressions::Expression<Func<TSource, TElement> ^> ^ elementSelector, System::Linq::Expressions::Expression<Func<TKey, System::Collections::Generic::IEnumerable<TElement> ^, TResult> ^> ^ resultSelector);
public static System.Linq.IQueryable<TResult> GroupBy<TSource,TKey,TElement,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TSource,TElement>> elementSelector, System.Linq.Expressions.Expression<Func<TKey,System.Collections.Generic.IEnumerable<TElement>,TResult>> resultSelector);
static member GroupBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Linq.Expressions.Expression<Func<'Source, 'Element>> * System.Linq.Expressions.Expression<Func<'Key, seq<'Element>, 'Result>> -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function GroupBy(Of TSource, TKey, TElement, TResult) (source As IQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey)), elementSelector As Expression(Of Func(Of TSource, TElement)), resultSelector As Expression(Of Func(Of TKey, IEnumerable(Of TElement), TResult))) As IQueryable(Of TResult)
Параметры типа
- TSource
Тип элементов source
.The type of the elements of source
.
- TKey
Тип ключа, возвращаемого функцией, заданной параметром keySelector
.The type of the key returned by the function represented in keySelector
.
- TElement
Тип элементов каждого объекта IGrouping<TKey,TElement>.The type of the elements in each IGrouping<TKey,TElement>.
- TResult
Тип результирующего значения, возвращаемого функцией resultSelector
.The type of the result value returned by resultSelector
.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, элементы которого следует сгруппировать.An IQueryable<T> whose elements to group.
- keySelector
- Expression<Func<TSource,TKey>>
Функция, извлекающая ключ для каждого элемента.A function to extract the key for each element.
- elementSelector
- Expression<Func<TSource,TElement>>
Функция, сопоставляющая каждый исходный элемент с элементом объекта IGrouping<TKey,TElement>.A function to map each source element to an element in an IGrouping<TKey,TElement>.
- resultSelector
- Expression<Func<TKey,IEnumerable<TElement>,TResult>>
Функция для создания результирующего значения для каждой группы.A function to create a result value from each group.
Возвращаемое значение
- IQueryable<TResult>
Объект T:System.Linq.IQueryable`1
с аргументом типа TResult
, каждый элемент которого представляет проекцию группы и ее ключа.An T:System.Linq.IQueryable`1
that has a type argument of TResult
and where each element represents a projection over a group and its key.
Исключения
Значение параметра source
или keySelector
или elementSelector
или resultSelector
— null
.source
or keySelector
or elementSelector
or resultSelector
is null
.
Примеры
В следующем примере кода показано, как использовать GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>) для группирования элементов последовательности и для проецирования последовательности результатов типа TResult
.The following code example demonstrates how to use GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>) to group the elements of a sequence and project a sequence of results of type TResult
.
class Pet
{
public string Name { get; set; }
public double Age { get; set; }
}
public static void GroupByEx4()
{
// Create a list of pets.
List<Pet> petsList =
new List<Pet>{ new Pet { Name="Barley", Age=8.3 },
new Pet { Name="Boots", Age=4.9 },
new Pet { Name="Whiskers", Age=1.5 },
new Pet { Name="Daisy", Age=4.3 } };
// Group Pet.Age values by the Math.Floor of the age.
// Then project an anonymous type from each group
// that consists of the key, the count of the group's
// elements, and the minimum and maximum age in the group.
var query = petsList.AsQueryable().GroupBy(
pet => Math.Floor(pet.Age),
pet => pet.Age,
(baseAge, ages) => new
{
Key = baseAge,
Count = ages.Count(),
Min = ages.Min(),
Max = ages.Max()
});
// Iterate over each anonymous type.
foreach (var result in query)
{
Console.WriteLine("\nAge group: " + result.Key);
Console.WriteLine("Number of pets in this age group: " + result.Count);
Console.WriteLine("Minimum age: " + result.Min);
Console.WriteLine("Maximum age: " + result.Max);
}
/* This code produces the following output:
Age group: 8
Number of pets in this age group: 1
Minimum age: 8.3
Maximum age: 8.3
Age group: 4
Number of pets in this age group: 2
Minimum age: 4.3
Maximum age: 4.9
Age group: 1
Number of pets in this age group: 1
Minimum age: 1.5
Maximum age: 1.5
*/
}
Structure Pet
Public Name As String
Public Age As Double
End Structure
Shared Sub GroupByEx4()
' Create a list of pets.
Dim petsList As New List(Of Pet)(New Pet() { _
New Pet With {.Name = "Barley", .Age = 8.3}, _
New Pet With {.Name = "Boots", .Age = 4.9}, _
New Pet With {.Name = "Whiskers", .Age = 1.5}, _
New Pet With {.Name = "Daisy", .Age = 4.3}})
' Group Pet.Age valuesby the Math.Floor of the age.
' Then project an anonymous type from each group
' that consists of the key, the count of the group's
' elements, and the minimum and maximum age in the group.
Dim query = petsList.AsQueryable().GroupBy( _
Function(pet) Math.Floor(pet.Age), _
Function(pet) pet.Age, _
Function(baseAge, ages) New With { _
.Key = baseAge, _
.Count = ages.Count(), _
.Min = ages.Min(), _
.Max = ages.Max() _
})
Dim output As New System.Text.StringBuilder
' Iterate over each anonymous type.
For Each result In query
output.AppendLine(vbCrLf & "Age group: " & result.Key)
output.AppendLine("Number of pets with this age: " & result.Count)
output.AppendLine("Minimum age: " & result.Min)
output.AppendLine("Maximum age: " & result.Max)
Next
' Display the output.
MsgBox(output.ToString())
' This code produces the following output:
' Age group: 8
' Number of pets with this age: 1
' Minimum age: 8.3
' Maximum age: 8.3
' Age group: 4
' Number of pets with this age: 2
' Minimum age: 4.3
' Maximum age: 4.9
' Age group: 1
' Number of pets with this age: 1
' Minimum age: 1.5
' Maximum age: 1.5
End Sub
Комментарии
Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.
GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>)Метод создает объект MethodCallExpression , который представляет вызов GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>) самого себя как сконструированного универсального метода.The GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>) method generates a MethodCallExpression that represents calling GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>) itself as a constructed generic method. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source
параметра.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source
parameter.
Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>) зависит от реализации типа source
параметра.The query behavior that occurs as a result of executing an expression tree that represents calling GroupBy<TSource,TKey,TElement,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, Expression<Func<TKey,IEnumerable<TElement>,TResult>>) depends on the implementation of the type of the source
parameter. Ожидаемое поведение заключается в том, что он группирует элементы source
по ключевым значениям, получаемым путем вызова keySelector
для каждого элемента.The expected behavior is that it groups the elements of source
by key values that are obtained by invoking keySelector
on each element. elementSelector
Параметр используется для проецирования элементов каждой группы, а resultSelector
параметр используется для получения результирующего значения из каждой группы и ее ключа.The elementSelector
parameter is used to project the elements of each group, and the resultSelector
parameter is used to obtain a result value from each group and its key.
Применяется к
GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>)
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и проецирует элементы каждой группы с помощью указанной функции.Groups the elements of a sequence according to a specified key selector function and projects the elements for each group by using a specified function.
public:
generic <typename TSource, typename TKey, typename TElement>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<System::Linq::IGrouping<TKey, TElement> ^> ^ GroupBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector, System::Linq::Expressions::Expression<Func<TSource, TElement> ^> ^ elementSelector);
public static System.Linq.IQueryable<System.Linq.IGrouping<TKey,TElement>> GroupBy<TSource,TKey,TElement> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TSource,TElement>> elementSelector);
static member GroupBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Linq.Expressions.Expression<Func<'Source, 'Element>> -> System.Linq.IQueryable<System.Linq.IGrouping<'Key, 'Element>>
<Extension()>
Public Function GroupBy(Of TSource, TKey, TElement) (source As IQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey)), elementSelector As Expression(Of Func(Of TSource, TElement))) As IQueryable(Of IGrouping(Of TKey, TElement))
Параметры типа
- TSource
Тип элементов source
.The type of the elements of source
.
- TKey
Тип ключа, возвращаемого функцией, заданной параметром keySelector
.The type of the key returned by the function represented in keySelector
.
- TElement
Тип элементов каждого объекта IGrouping<TKey,TElement>.The type of the elements in each IGrouping<TKey,TElement>.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, элементы которого следует сгруппировать.An IQueryable<T> whose elements to group.
- keySelector
- Expression<Func<TSource,TKey>>
Функция, извлекающая ключ для каждого элемента.A function to extract the key for each element.
- elementSelector
- Expression<Func<TSource,TElement>>
Функция, сопоставляющая каждый исходный элемент с элементом объекта IGrouping<TKey,TElement>.A function to map each source element to an element in an IGrouping<TKey,TElement>.
Возвращаемое значение
- IQueryable<IGrouping<TKey,TElement>>
Объект IQueryable<IGrouping<TKey, TElement>>
в C# или IQueryable(Of IGrouping(Of TKey, TElement))
в Visual Basic, где каждый объект IGrouping<TKey,TElement> содержит последовательность объектов типа TElement
и ключ.An IQueryable<IGrouping<TKey, TElement>>
in C# or IQueryable(Of IGrouping(Of TKey, TElement))
in Visual Basic where each IGrouping<TKey,TElement> contains a sequence of objects of type TElement
and a key.
Исключения
Параметр source
, keySelector
или elementSelector
имеет значение null
.source
or keySelector
or elementSelector
is null
.
Примеры
В следующем примере кода показано, как использовать GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>) для группирования элементов последовательности.The following code example demonstrates how to use GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>) to group the elements of a sequence.
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void GroupByEx2()
{
// Create a list of Pet objects.
List<Pet> pets =
new List<Pet>{ new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 },
new Pet { Name="Daisy", Age=4 } };
// Group the pets using Pet.Age as the key.
// Use Pet.Name as the value for each entry.
IEnumerable<IGrouping<int, string>> query =
pets.AsQueryable().GroupBy(pet => pet.Age, pet => pet.Name);
// Iterate over each IGrouping in the collection.
foreach (IGrouping<int, string> petGroup in query)
{
// Print the key value of the IGrouping.
Console.WriteLine(petGroup.Key);
// Iterate over each value in the
// IGrouping and print the value.
foreach (string name in petGroup)
Console.WriteLine(" {0}", name);
}
}
/*
This code produces the following output:
8
Barley
4
Boots
Daisy
1
Whiskers
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Shared Sub GroupByEx2()
' Create a list of Pet objects.
Dim pets As New List(Of Pet)(New Pet() { _
New Pet With {.Name = "Barley", .Age = 8}, _
New Pet With {.Name = "Boots", .Age = 4}, _
New Pet With {.Name = "Whiskers", .Age = 1}, _
New Pet With {.Name = "Daisy", .Age = 4}})
' Group the pets using Pet.Age as the key.
' Use Pet.Name as the value for each entry.
Dim query As IEnumerable(Of IGrouping(Of Integer, String)) = _
pets.AsQueryable().GroupBy(Function(pet) pet.Age, Function(pet) pet.Name)
Dim output As New System.Text.StringBuilder
' Iterate over each IGrouping in the collection.
For Each petGroup As IGrouping(Of Integer, String) In query
' Print the key value of the IGrouping.
output.AppendLine(petGroup.Key)
' Iterate over each value in the
' IGrouping and print the value.
For Each name As String In petGroup
output.AppendLine(String.Format(" {0}", name))
Next
Next
' Display the output.
MsgBox(output.ToString())
End Sub
' This code produces the following output:
'
' 8
' Barley
' 4
' Boots
' Daisy
' 1
' Whiskers
Комментарии
Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.
GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>)Метод создает объект MethodCallExpression , который представляет вызов GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>) самого себя как сконструированного универсального метода.The GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>) method generates a MethodCallExpression that represents calling GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>) itself as a constructed generic method. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source
параметра.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source
parameter.
Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>) зависит от реализации типа source
параметра.The query behavior that occurs as a result of executing an expression tree that represents calling GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>) depends on the implementation of the type of the source
parameter. Ожидаемое поведение заключается в том, что он группирует элементы source
по значению ключа, полученному путем вызова keySelector
для каждого элемента.The expected behavior is that it groups the elements of source
by a key value that is obtained by invoking keySelector
on each element. elementSelector
Для получения результирующего элемента он вызывается для каждого элемента.It invokes elementSelector
on each element to obtain a result element.
Применяется к
GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, IEqualityComparer<TKey>)
Группирует элементы последовательности и проецирует элементы каждой группы с помощью указанной функции.Groups the elements of a sequence and projects the elements for each group by using a specified function. Значения ключей сравниваются с использованием заданного компаратора.Key values are compared by using a specified comparer.
public:
generic <typename TSource, typename TKey, typename TElement>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<System::Linq::IGrouping<TKey, TElement> ^> ^ GroupBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector, System::Linq::Expressions::Expression<Func<TSource, TElement> ^> ^ elementSelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public static System.Linq.IQueryable<System.Linq.IGrouping<TKey,TElement>> GroupBy<TSource,TKey,TElement> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TSource,TElement>> elementSelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public static System.Linq.IQueryable<System.Linq.IGrouping<TKey,TElement>> GroupBy<TSource,TKey,TElement> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TSource,TElement>> elementSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);
static member GroupBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Linq.Expressions.Expression<Func<'Source, 'Element>> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Linq.IQueryable<System.Linq.IGrouping<'Key, 'Element>>
<Extension()>
Public Function GroupBy(Of TSource, TKey, TElement) (source As IQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey)), elementSelector As Expression(Of Func(Of TSource, TElement)), comparer As IEqualityComparer(Of TKey)) As IQueryable(Of IGrouping(Of TKey, TElement))
Параметры типа
- TSource
Тип элементов source
.The type of the elements of source
.
- TKey
Тип ключа, возвращаемого функцией, заданной параметром keySelector
.The type of the key returned by the function represented in keySelector
.
- TElement
Тип элементов каждого объекта IGrouping<TKey,TElement>.The type of the elements in each IGrouping<TKey,TElement>.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, элементы которого следует сгруппировать.An IQueryable<T> whose elements to group.
- keySelector
- Expression<Func<TSource,TKey>>
Функция, извлекающая ключ для каждого элемента.A function to extract the key for each element.
- elementSelector
- Expression<Func<TSource,TElement>>
Функция, сопоставляющая каждый исходный элемент с элементом объекта IGrouping<TKey,TElement>.A function to map each source element to an element in an IGrouping<TKey,TElement>.
- comparer
- IEqualityComparer<TKey>
Компаратор IEqualityComparer<T>, используемый для сравнения ключей.An IEqualityComparer<T> to compare keys.
Возвращаемое значение
- IQueryable<IGrouping<TKey,TElement>>
Объект IQueryable<IGrouping<TKey, TElement>>
в C# или IQueryable(Of IGrouping(Of TKey, TElement))
в Visual Basic, где каждый объект IGrouping<TKey,TElement> содержит последовательность объектов типа TElement
и ключ.An IQueryable<IGrouping<TKey, TElement>>
in C# or IQueryable(Of IGrouping(Of TKey, TElement))
in Visual Basic where each IGrouping<TKey,TElement> contains a sequence of objects of type TElement
and a key.
Исключения
Значение параметра source
или keySelector
или elementSelector
или comparer
— null
.source
or keySelector
or elementSelector
or comparer
is null
.
Комментарии
Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.
GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, IEqualityComparer<TKey>)Метод создает объект MethodCallExpression , который представляет вызов GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, IEqualityComparer<TKey>) самого себя как сконструированного универсального метода.The GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, IEqualityComparer<TKey>) method generates a MethodCallExpression that represents calling GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, IEqualityComparer<TKey>) itself as a constructed generic method. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source
параметра.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source
parameter.
Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, IEqualityComparer<TKey>) зависит от реализации типа source
параметра.The query behavior that occurs as a result of executing an expression tree that represents calling GroupBy<TSource,TKey,TElement>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TSource,TElement>>, IEqualityComparer<TKey>) depends on the implementation of the type of the source
parameter. Ожидаемое поведение заключается в том, что он группирует элементы source
по значению ключа, полученному путем вызова keySelector
для каждого элемента.The expected behavior is that it groups the elements of source
by a key value that is obtained by invoking keySelector
on each element. Значения ключа сравниваются с помощью comparer
.Key values are compared by using comparer
. elementSelector
Параметр вызывается для каждого элемента для получения результирующего элемента.The elementSelector
parameter is invoked on each element to obtain a result element.
Применяется к
GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>)
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и создает результирующее значение для каждой группы и ее ключа.Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key.
public:
generic <typename TSource, typename TKey, typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<TResult> ^ GroupBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector, System::Linq::Expressions::Expression<Func<TKey, System::Collections::Generic::IEnumerable<TSource> ^, TResult> ^> ^ resultSelector);
public static System.Linq.IQueryable<TResult> GroupBy<TSource,TKey,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TKey,System.Collections.Generic.IEnumerable<TSource>,TResult>> resultSelector);
static member GroupBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Linq.Expressions.Expression<Func<'Key, seq<'Source>, 'Result>> -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function GroupBy(Of TSource, TKey, TResult) (source As IQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey)), resultSelector As Expression(Of Func(Of TKey, IEnumerable(Of TSource), TResult))) As IQueryable(Of TResult)
Параметры типа
- TSource
Тип элементов source
.The type of the elements of source
.
- TKey
Тип ключа, возвращаемого функцией, заданной параметром keySelector
.The type of the key returned by the function represented in keySelector
.
- TResult
Тип результирующего значения, возвращаемого функцией resultSelector
.The type of the result value returned by resultSelector
.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, элементы которого следует сгруппировать.An IQueryable<T> whose elements to group.
- keySelector
- Expression<Func<TSource,TKey>>
Функция, извлекающая ключ для каждого элемента.A function to extract the key for each element.
- resultSelector
- Expression<Func<TKey,IEnumerable<TSource>,TResult>>
Функция для создания результирующего значения для каждой группы.A function to create a result value from each group.
Возвращаемое значение
- IQueryable<TResult>
Объект T:System.Linq.IQueryable`1
с аргументом типа TResult
, каждый элемент которого представляет проекцию группы и ее ключа.An T:System.Linq.IQueryable`1
that has a type argument of TResult
and where each element represents a projection over a group and its key.
Исключения
Параметр source
, keySelector
или resultSelector
имеет значение null
.source
or keySelector
or resultSelector
is null
.
Примеры
В следующем примере кода показано, как использовать GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>) для группирования элементов последовательности и для проецирования последовательности результатов типа TResult
.The following code example demonstrates how to use GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>) to group the elements of a sequence and project a sequence of results of type TResult
.
class Pet
{
public string Name { get; set; }
public double Age { get; set; }
}
public static void GroupByEx3()
{
// Create a list of pets.
List<Pet> petsList =
new List<Pet>{ new Pet { Name="Barley", Age=8.3 },
new Pet { Name="Boots", Age=4.9 },
new Pet { Name="Whiskers", Age=1.5 },
new Pet { Name="Daisy", Age=4.3 } };
// Group Pet objects by the Math.Floor of their age.
// Then project an anonymous type from each group
// that consists of the key, the count of the group's
// elements, and the minimum and maximum age in the group.
var query = petsList.AsQueryable().GroupBy(
pet => Math.Floor(pet.Age),
(age, pets) => new
{
Key = age,
Count = pets.Count(),
Min = pets.Min(pet => pet.Age),
Max = pets.Max(pet => pet.Age)
});
// Iterate over each anonymous type.
foreach (var result in query)
{
Console.WriteLine("\nAge group: " + result.Key);
Console.WriteLine("Number of pets in this age group: " + result.Count);
Console.WriteLine("Minimum age: " + result.Min);
Console.WriteLine("Maximum age: " + result.Max);
}
/* This code produces the following output:
Age group: 8
Number of pets in this age group: 1
Minimum age: 8.3
Maximum age: 8.3
Age group: 4
Number of pets in this age group: 2
Minimum age: 4.3
Maximum age: 4.9
Age group: 1
Number of pets in this age group: 1
Minimum age: 1.5
Maximum age: 1.5
*/
}
Structure Pet
Public Name As String
Public Age As Double
End Structure
Shared Sub GroupByEx3()
' Create a list of pets.
Dim petsList As New List(Of Pet)(New Pet() { _
New Pet With {.Name = "Barley", .Age = 8.3}, _
New Pet With {.Name = "Boots", .Age = 4.9}, _
New Pet With {.Name = "Whiskers", .Age = 1.5}, _
New Pet With {.Name = "Daisy", .Age = 4.3}})
' Group Pet objects by the Math.Floor of their age.
' Then project an anonymous type from each group
' that consists of the key, the count of the group's
' elements, and the minimum and maximum age in the group.
Dim query = petsList.AsQueryable().GroupBy( _
Function(pet) Math.Floor(pet.Age), _
Function(age, pets) New With { _
.Key = age, _
.Count = pets.Count(), _
.Min = pets.Min(Function(pet) pet.Age), _
.Max = pets.Max(Function(pet) pet.Age) _
})
Dim output As New System.Text.StringBuilder
' Iterate over each anonymous type.
For Each result In query
output.AppendLine(vbCrLf & "Age group: " & result.Key)
output.AppendLine("Number of pets with this age: " & result.Count)
output.AppendLine("Minimum age: " & result.Min)
output.AppendLine("Maximum age: " & result.Max)
Next
' Display the output.
MsgBox(output.ToString())
' This code produces the following output:
' Age group: 8
' Number of pets with this age: 1
' Minimum age: 8.3
' Maximum age: 8.3
' Age group: 4
' Number of pets with this age: 2
' Minimum age: 4.3
' Maximum age: 4.9
' Age group: 1
' Number of pets with this age: 1
' Minimum age: 1.5
' Maximum age: 1.5
End Sub
Комментарии
Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.
GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>)Метод создает объект MethodCallExpression , который представляет вызов GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>) самого себя как сконструированного универсального метода.The GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>) method generates a MethodCallExpression that represents calling GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>) itself as a constructed generic method. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source
параметра.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source
parameter.
Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>) зависит от реализации типа source
параметра.The query behavior that occurs as a result of executing an expression tree that represents calling GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>) depends on the implementation of the type of the source
parameter. Ожидаемое поведение заключается в том, что он группирует элементы source
по значению ключа, полученному путем вызова keySelector
для каждого элемента.The expected behavior is that it groups the elements of source
by a key value that is obtained by invoking keySelector
on each element. resultSelector
Параметр используется для получения результирующего значения из каждой группы и ее ключа.The resultSelector
parameter is used to obtain a result value from each group and its key.
Применяется к
GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>, IEqualityComparer<TKey>)
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и создает результирующее значение для каждой группы и ее ключа.Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Ключи сравниваются с использованием заданного компаратора.Keys are compared by using a specified comparer.
public:
generic <typename TSource, typename TKey, typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<TResult> ^ GroupBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector, System::Linq::Expressions::Expression<Func<TKey, System::Collections::Generic::IEnumerable<TSource> ^, TResult> ^> ^ resultSelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public static System.Linq.IQueryable<TResult> GroupBy<TSource,TKey,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TKey,System.Collections.Generic.IEnumerable<TSource>,TResult>> resultSelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public static System.Linq.IQueryable<TResult> GroupBy<TSource,TKey,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Linq.Expressions.Expression<Func<TKey,System.Collections.Generic.IEnumerable<TSource>,TResult>> resultSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);
static member GroupBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Linq.Expressions.Expression<Func<'Key, seq<'Source>, 'Result>> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function GroupBy(Of TSource, TKey, TResult) (source As IQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey)), resultSelector As Expression(Of Func(Of TKey, IEnumerable(Of TSource), TResult)), comparer As IEqualityComparer(Of TKey)) As IQueryable(Of TResult)
Параметры типа
- TSource
Тип элементов source
.The type of the elements of source
.
- TKey
Тип ключа, возвращаемого функцией, заданной параметром keySelector
.The type of the key returned by the function represented in keySelector
.
- TResult
Тип результирующего значения, возвращаемого функцией resultSelector
.The type of the result value returned by resultSelector
.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, элементы которого следует сгруппировать.An IQueryable<T> whose elements to group.
- keySelector
- Expression<Func<TSource,TKey>>
Функция, извлекающая ключ для каждого элемента.A function to extract the key for each element.
- resultSelector
- Expression<Func<TKey,IEnumerable<TSource>,TResult>>
Функция для создания результирующего значения для каждой группы.A function to create a result value from each group.
- comparer
- IEqualityComparer<TKey>
Компаратор IEqualityComparer<T>, используемый для сравнения ключей.An IEqualityComparer<T> to compare keys.
Возвращаемое значение
- IQueryable<TResult>
Объект T:System.Linq.IQueryable`1
с аргументом типа TResult
, каждый элемент которого представляет проекцию группы и ее ключа.An T:System.Linq.IQueryable`1
that has a type argument of TResult
and where each element represents a projection over a group and its key.
Исключения
Значение параметра source
или keySelector
или resultSelector
или comparer
— null
.source
or keySelector
or resultSelector
or comparer
is null
.
Комментарии
Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.
GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>, IEqualityComparer<TKey>)Метод создает объект MethodCallExpression , который представляет вызов GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>, IEqualityComparer<TKey>) самого себя как сконструированного универсального метода.The GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>, IEqualityComparer<TKey>) method generates a MethodCallExpression that represents calling GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>, IEqualityComparer<TKey>) itself as a constructed generic method. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source
параметра.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source
parameter.
Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>, IEqualityComparer<TKey>) зависит от реализации типа source
параметра.The query behavior that occurs as a result of executing an expression tree that represents calling GroupBy<TSource,TKey,TResult>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, Expression<Func<TKey,IEnumerable<TSource>,TResult>>, IEqualityComparer<TKey>) depends on the implementation of the type of the source
parameter. Ожидаемое поведение заключается в том, что он группирует элементы source
по ключевым значениям, получаемым путем вызова keySelector
для каждого элемента.The expected behavior is that it groups the elements of source
by key values that are obtained by invoking keySelector
on each element. comparer
Параметр используется для сравнения ключей, а параметр используется resultSelector
для получения результирующего значения из каждой группы и ее ключа.The comparer
parameter is used to compare keys and the resultSelector
parameter is used to obtain a result value from each group and its key.
Применяется к
GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IEqualityComparer<TKey>)
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа и сравнивает ключи с помощью указанного компаратора.Groups the elements of a sequence according to a specified key selector function and compares the keys by using a specified comparer.
public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<System::Linq::IGrouping<TKey, TSource> ^> ^ GroupBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public static System.Linq.IQueryable<System.Linq.IGrouping<TKey,TSource>> GroupBy<TSource,TKey> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public static System.Linq.IQueryable<System.Linq.IGrouping<TKey,TSource>> GroupBy<TSource,TKey> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);
static member GroupBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Linq.IQueryable<System.Linq.IGrouping<'Key, 'Source>>
<Extension()>
Public Function GroupBy(Of TSource, TKey) (source As IQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey)), comparer As IEqualityComparer(Of TKey)) As IQueryable(Of IGrouping(Of TKey, TSource))
Параметры типа
- TSource
Тип элементов source
.The type of the elements of source
.
- TKey
Тип ключа, возвращаемого функцией, заданной параметром keySelector
.The type of the key returned by the function represented in keySelector
.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, элементы которого следует сгруппировать.An IQueryable<T> whose elements to group.
- keySelector
- Expression<Func<TSource,TKey>>
Функция, извлекающая ключ для каждого элемента.A function to extract the key for each element.
- comparer
- IEqualityComparer<TKey>
Компаратор IEqualityComparer<T>, используемый для сравнения ключей.An IEqualityComparer<T> to compare keys.
Возвращаемое значение
- IQueryable<IGrouping<TKey,TSource>>
Объект IQueryable<IGrouping<TKey, TSource>>
в C# или IQueryable(Of IGrouping(Of TKey, TSource))
в Visual Basic, где каждый объект IGrouping<TKey,TElement> содержит последовательность объектов и ключ.An IQueryable<IGrouping<TKey, TSource>>
in C# or IQueryable(Of IGrouping(Of TKey, TSource))
in Visual Basic where each IGrouping<TKey,TElement> contains a sequence of objects and a key.
Исключения
Параметр source
, keySelector
или comparer
имеет значение null
.source
or keySelector
or comparer
is null
.
Комментарии
Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.
GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IEqualityComparer<TKey>)Метод создает объект MethodCallExpression , который представляет вызов GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IEqualityComparer<TKey>) самого себя как сконструированного универсального метода.The GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IEqualityComparer<TKey>) method generates a MethodCallExpression that represents calling GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IEqualityComparer<TKey>) itself as a constructed generic method. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source
параметра.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source
parameter.
Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IEqualityComparer<TKey>) зависит от реализации типа source
параметра.The query behavior that occurs as a result of executing an expression tree that represents calling GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IEqualityComparer<TKey>) depends on the implementation of the type of the source
parameter. Ожидаемое поведение заключается в том, что он группирует элементы source
по значению ключа.The expected behavior is that it groups the elements of source
by a key value. Значение ключа получается путем вызова keySelector
для каждого элемента, а значения ключа сравниваются с помощью comparer
.The key value is obtained by invoking keySelector
on each element, and key values are compared by using comparer
.
Применяется к
GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>)
Группирует элементы последовательности в соответствии с заданной функцией селектора ключа.Groups the elements of a sequence according to a specified key selector function.
public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<System::Linq::IGrouping<TKey, TSource> ^> ^ GroupBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector);
public static System.Linq.IQueryable<System.Linq.IGrouping<TKey,TSource>> GroupBy<TSource,TKey> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector);
static member GroupBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> -> System.Linq.IQueryable<System.Linq.IGrouping<'Key, 'Source>>
<Extension()>
Public Function GroupBy(Of TSource, TKey) (source As IQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey))) As IQueryable(Of IGrouping(Of TKey, TSource))
Параметры типа
- TSource
Тип элементов source
.The type of the elements of source
.
- TKey
Тип ключа, возвращаемого функцией, заданной параметром keySelector
.The type of the key returned by the function represented in keySelector
.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, элементы которого следует сгруппировать.An IQueryable<T> whose elements to group.
- keySelector
- Expression<Func<TSource,TKey>>
Функция, извлекающая ключ для каждого элемента.A function to extract the key for each element.
Возвращаемое значение
- IQueryable<IGrouping<TKey,TSource>>
Объект IQueryable<IGrouping<TKey, TSource>>
в C# или IQueryable(Of IGrouping(Of TKey, TSource))
в Visual Basic, где каждый объект IGrouping<TKey,TElement> содержит последовательность объектов и ключ.An IQueryable<IGrouping<TKey, TSource>>
in C# or IQueryable(Of IGrouping(Of TKey, TSource))
in Visual Basic where each IGrouping<TKey,TElement> object contains a sequence of objects and a key.
Исключения
Параметр source
или keySelector
имеет значение null
.source
or keySelector
is null
.
Примеры
В следующем примере кода показано, как использовать GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) для группирования элементов последовательности.The following code example demonstrates how to use GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) to group the elements of a sequence.
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void GroupByEx1()
{
// Create a list of Pet objects.
List<Pet> pets =
new List<Pet>{ new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 },
new Pet { Name="Daisy", Age=4 } };
// Group the pets using Pet.Age as the key.
// Use Pet.Name as the value for each entry.
var query = pets.AsQueryable().GroupBy(pet => pet.Age);
// Iterate over each IGrouping in the collection.
foreach (var ageGroup in query)
{
Console.WriteLine("Age group: {0} Number of pets: {1}", ageGroup.Key, ageGroup.Count());
}
}
/*
This code produces the following output:
Age group: 8 Number of pets: 1
Age group: 4 Number of pets: 2
Age group: 1 Number of pets: 1
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Shared Sub GroupByEx1()
' Create a list of Pet objects.
Dim pets As New List(Of Pet)(New Pet() { _
New Pet With {.Name = "Barley", .Age = 8}, _
New Pet With {.Name = "Boots", .Age = 4}, _
New Pet With {.Name = "Whiskers", .Age = 1}, _
New Pet With {.Name = "Daisy", .Age = 4}})
' Group the pets using Pet.Age as the key.
' Use Pet.Name as the value for each entry.
Dim query = pets.AsQueryable().GroupBy(Function(pet) pet.Age)
Dim output As New System.Text.StringBuilder
' Iterate over each IGrouping in the collection.
For Each ageGroup In query
output.AppendFormat("Age group: {0} Number of pets: {1}{2}", ageGroup.Key, ageGroup.Count(), vbCrLf)
Next
' Display the output.
MsgBox(output.ToString())
End Sub
' This code produces the following output:
'
' Age group: 8 Number of pets: 1
' Age group: 4 Number of pets: 2
' Age group: 1 Number of pets: 1
Комментарии
Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.
GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>)Метод создает объект MethodCallExpression , который представляет вызов GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) самого себя как сконструированного универсального метода.The GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) method generates a MethodCallExpression that represents calling GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) itself as a constructed generic method. Затем он передает MethodCallExpression CreateQuery<TElement>(Expression) методу класса, IQueryProvider представленного Provider свойством source
параметра.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source
parameter.
Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) зависит от реализации типа source
параметра.The query behavior that occurs as a result of executing an expression tree that represents calling GroupBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) depends on the implementation of the type of the source
parameter. Ожидаемое поведение заключается в том, что он группирует элементы source
по значению ключа, полученному путем вызова keySelector
для каждого элемента.The expected behavior is that it groups the elements of source
by a key value that is obtained by invoking keySelector
on each element.