group – klauzule (Referenční dokumentace jazyka C#)
Klauzule group vrátí posloupnost IGrouping<TKey,TElement> objektů, které obsahují nula nebo více položek, které odpovídají hodnotě klíče pro skupinu. Můžete například seskupit posloupnost řetězců podle prvního písmena v každém řetězci. V tomto případě je první písmeno klíčem a má znak typu a je uložen ve vlastnosti každého IGrouping<TKey,TElement> objektuKey. Kompilátor odvodí typ klíče.
Výraz group dotazu můžete ukončit klauzulí, jak je znázorněno v následujícím příkladu:
// Query variable is an IEnumerable<IGrouping<char, Student>>
var studentQuery1 =
from student in students
group student by student.Last[0];
Pokud chcete pro každou skupinu provádět další operace dotazu, můžete pomocí kontextového klíčového slova zadat dočasný identifikátor. Při použití intomusíte pokračovat s dotazem a nakonec ho ukončit příkazem nebo jinou select group klauzulí, jak je znázorněno v následujícím výňatku:
// Group students by the first letter of their last name
// Query variable is an IEnumerable<IGrouping<char, Student>>
var studentQuery2 =
from student in students
group student by student.Last[0] into g
orderby g.Key
select g;
Podrobnější příklady použití group s a bez into použití jsou uvedeny v části Příklad tohoto článku.
Vytvoření výčtu výsledků skupinového dotazu
IGrouping<TKey,TElement> Protože objekty vytvořené dotazem group jsou v podstatě seznam seznamů, musíte použít vnořenou smyčku foreach pro přístup k položkám v každé skupině. Vnější smyčka iteruje přes klíče skupiny a vnitřní smyčka iteruje přes každou položku v samotné skupině. Skupina může mít klíč, ale žádné prvky. Následuje smyčka foreach , která provede dotaz v předchozích příkladech kódu:
// Iterate group items with a nested foreach. This IGrouping encapsulates
// a sequence of Student objects, and a Key of type char.
// For convenience, var can also be used in the foreach statement.
foreach (IGrouping<char, Student> studentGroup in studentQuery2)
{
Console.WriteLine(studentGroup.Key);
// Explicit type for student could also be used here.
foreach (var student in studentGroup)
{
Console.WriteLine(" {0}, {1}", student.Last, student.First);
}
}
Typy klíčů
Klíče skupiny můžou být libovolný typ, například řetězec, předdefinovaný číselný typ nebo uživatelem definovaný pojmenovaný typ nebo anonymní typ.
Seskupování podle řetězce
Předchozí příklady kódu používaly znak .char Místo toho je možné zadat řetězcový klíč, například úplné příjmení:
// Same as previous example except we use the entire last name as a key.
// Query variable is an IEnumerable<IGrouping<string, Student>>
var studentQuery3 =
from student in students
group student by student.Last;
Seskupování podle logické hodnoty
Následující příklad ukazuje použití logické hodnoty klíče k rozdělení výsledků do dvou skupin. Všimněte si, že hodnota je vytvořena dílčím výrazem v group klauzuli.
class GroupSample1
{
// The element type of the data source.
public class Student
{
public required string First { get; init; }
public required string Last { get; init; }
public required int ID { get; init; }
public required List<int> Scores;
}
public static List<Student> GetStudents()
{
// Use a collection initializer to create the data source. Note that each element
// in the list contains an inner sequence of scores.
List<Student> students =
[
new Student {First="Svetlana", Last="Omelchenko", ID=111, Scores= [97, 72, 81, 60]},
new Student {First="Claire", Last="O'Donnell", ID=112, Scores= [75, 84, 91, 39]},
new Student {First="Sven", Last="Mortensen", ID=113, Scores= [99, 89, 91, 95]},
new Student {First="Cesar", Last="Garcia", ID=114, Scores= [72, 81, 65, 84]},
new Student {First="Debra", Last="Garcia", ID=115, Scores= [97, 89, 85, 82]}
];
return students;
}
static void Main()
{
// Obtain the data source.
List<Student> students = GetStudents();
// Group by true or false.
// Query variable is an IEnumerable<IGrouping<bool, Student>>
var booleanGroupQuery =
from student in students
group student by student.Scores.Average() >= 80; //pass or fail!
// Execute the query and access items in each group
foreach (var studentGroup in booleanGroupQuery)
{
Console.WriteLine(studentGroup.Key == true ? "High averages" : "Low averages");
foreach (var student in studentGroup)
{
Console.WriteLine(" {0}, {1}:{2}", student.Last, student.First, student.Scores.Average());
}
}
}
}
/* Output:
Low averages
Omelchenko, Svetlana:77.5
O'Donnell, Claire:72.25
Garcia, Cesar:75.5
High averages
Mortensen, Sven:93.5
Garcia, Debra:88.25
*/
Seskupení podle číselného rozsahu
V dalším příkladu se pomocí výrazu vytvoří klíče číselné skupiny, které představují oblast percentilu. Všimněte si použití let jako vhodného umístění pro uložení výsledku volání metody, takže nemusíte metodu group volat dvakrát v klauzuli. Další informace o tom, jak bezpečně používat metody ve výrazech dotazu, najdete v tématu Zpracování výjimek ve výrazech dotazu.
class GroupSample2
{
// The element type of the data source.
public class Student
{
public required string First { get; init; }
public required string Last { get; init; }
public required int ID { get; init; }
public required List<int> Scores;
}
public static List<Student> GetStudents()
{
// Use a collection initializer to create the data source. Note that each element
// in the list contains an inner sequence of scores.
List<Student> students =
[
new Student {First="Svetlana", Last="Omelchenko", ID=111, Scores= [97, 72, 81, 60]},
new Student {First="Claire", Last="O'Donnell", ID=112, Scores= [75, 84, 91, 39]},
new Student {First="Sven", Last="Mortensen", ID=113, Scores= [99, 89, 91, 95]},
new Student {First="Cesar", Last="Garcia", ID=114, Scores= [72, 81, 65, 84]},
new Student {First="Debra", Last="Garcia", ID=115, Scores= [97, 89, 85, 82]}
];
return students;
}
// This method groups students into percentile ranges based on their
// grade average. The Average method returns a double, so to produce a whole
// number it is necessary to cast to int before dividing by 10.
static void Main()
{
// Obtain the data source.
List<Student> students = GetStudents();
// Write the query.
var studentQuery =
from student in students
let avg = (int)student.Scores.Average()
group student by (avg / 10) into g
orderby g.Key
select g;
// Execute the query.
foreach (var studentGroup in studentQuery)
{
int temp = studentGroup.Key * 10;
Console.WriteLine("Students with an average between {0} and {1}", temp, temp + 10);
foreach (var student in studentGroup)
{
Console.WriteLine(" {0}, {1}:{2}", student.Last, student.First, student.Scores.Average());
}
}
}
}
/* Output:
Students with an average between 70 and 80
Omelchenko, Svetlana:77.5
O'Donnell, Claire:72.25
Garcia, Cesar:75.5
Students with an average between 80 and 90
Garcia, Debra:88.25
Students with an average between 90 and 100
Mortensen, Sven:93.5
*/
Seskupování podle složených klíčů
Složený klíč použijte, pokud chcete seskupit prvky podle více než jednoho klíče. Složený klíč vytvoříte pomocí anonymního typu nebo pojmenovaného typu pro uložení klíčového prvku. V následujícím příkladu předpokládejme, že třída Person byla deklarována se členy pojmenovanými surname a city. Klauzule group způsobí vytvoření samostatné skupiny pro každou sadu osob se stejným příjmením a stejným městem.
group person by new {name = person.surname, city = person.city};
Pokud je nutné předat proměnnou dotazu jiné metodě, použijte pojmenovaný typ. Vytvořte speciální třídu s použitím automaticky implementovaných vlastností pro klíče a pak přepište Equals metody a GetHashCode metody. Můžete také použít strukturu, v takovém případě nemusíte přísně přepsat tyto metody. Další informace naleznete v tématu Jak implementovat odlehčenou třídu s automaticky implementovanými vlastnostmi a jak dotazovat duplicitní soubory ve stromu adresáře. Druhý článek obsahuje příklad kódu, který ukazuje použití složeného klíče s pojmenovaným typem.
Příklad 1
Následující příklad ukazuje standardní vzor řazení zdrojových dat do skupin, pokud se u skupin nepoužije žádná další logika dotazu. Tomu se říká seskupení bez pokračování. Prvky v poli řetězců jsou seskupeny podle jejich prvního písmena. Výsledkem dotazu je IGrouping<TKey,TElement> typ, který obsahuje veřejnou Key vlastnost typu char a IEnumerable<T> kolekci, která obsahuje každou položku v seskupení.
Výsledkem group klauzule je posloupnost sekvencí. Proto pro přístup k jednotlivým prvkům v každé vrácené skupině použijte vnořenou foreach smyčku uvnitř smyčky, která iteruje klíče skupiny, jak je znázorněno v následujícím příkladu.
class GroupExample1
{
static void Main()
{
// Create a data source.
string[] words = ["blueberry", "chimpanzee", "abacus", "banana", "apple", "cheese"];
// Create the query.
var wordGroups =
from w in words
group w by w[0];
// Execute the query.
foreach (var wordGroup in wordGroups)
{
Console.WriteLine("Words that start with the letter '{0}':", wordGroup.Key);
foreach (var word in wordGroup)
{
Console.WriteLine(word);
}
}
}
}
/* Output:
Words that start with the letter 'b':
blueberry
banana
Words that start with the letter 'c':
chimpanzee
cheese
Words that start with the letter 'a':
abacus
apple
*/
Příklad 2
Tento příklad ukazuje, jak provést další logiku pro skupiny po jejich vytvoření pomocí pokračování s into. Další informace najdete v tématu. Následující příklad dotazuje každou skupinu, aby vybrali pouze ty, jejichž hodnota klíče je samohláska.
class GroupClauseExample2
{
static void Main()
{
// Create the data source.
string[] words2 = ["blueberry", "chimpanzee", "abacus", "banana", "apple", "cheese", "elephant", "umbrella", "anteater"];
// Create the query.
var wordGroups2 =
from w in words2
group w by w[0] into grps
where (grps.Key == 'a' || grps.Key == 'e' || grps.Key == 'i'
|| grps.Key == 'o' || grps.Key == 'u')
select grps;
// Execute the query.
foreach (var wordGroup in wordGroups2)
{
Console.WriteLine("Groups that start with a vowel: {0}", wordGroup.Key);
foreach (var word in wordGroup)
{
Console.WriteLine(" {0}", word);
}
}
}
}
/* Output:
Groups that start with a vowel: a
abacus
apple
anteater
Groups that start with a vowel: e
elephant
Groups that start with a vowel: u
umbrella
*/
Poznámky
V době group kompilace se klauzule překládají do volání metody GroupBy .
Vlastní porovnávač rovnosti není podporován v syntaxi group dotazu klauzule. Metodu použijte GroupBy explicitně, pokud chcete v dotazu využít IEqualityComparer .
