Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
group yan tümcesi bir nesne dizisi IGrouping<TKey,TElement> döndürür. Dizi, grubun anahtar değeriyle eşleşen sıfır veya daha fazla öğe içerir. Örneğin, bir dizi dizeyi her dizedeki ilk harfe göre gruplandırabilirsiniz. Bu durumda, ilk harf anahtardır ve karakter türündedir. Her IGrouping<TKey,TElement> nesne bu anahtarı kendi özelliğinde depolar Key . Derleyici, anahtarın türünü çıkarsar.
C# dili başvuru belgesi, C# dilinin en son yayımlanan sürümünü gösterir. Ayrıca, yaklaşan dil sürümü için genel önizlemelerdeki özelliklere yönelik ilk belgeleri içerir.
Belgelerde ilk olarak dilin son üç sürümünde veya geçerli genel önizlemelerde sunulan tüm özellikler tanımlanır.
Tavsiye
Bir özelliğin C# dilinde ilk tanıtıldığı zamanları bulmak için C# dil sürümü geçmişi makalesine bakın.
Aşağıdaki örnekte gösterildiği gibi sorgu ifadesini yan group tümcesiyle sonlandırabilirsiniz:
// Query variable is an IEnumerable<IGrouping<char, Student>>
var studentQuery1 =
from student in students
group student by student.Last[0];
Her grupta ek sorgu işlemleri gerçekleştirmek istiyorsanız, bağlamsal anahtar sözcüğünü kullanarak geçici bir tanımlayıcı belirtin. Siz into kullanırken, sorguya devam etmeniz ve sonunda ya bir select ifadesi ya da başka bir group yan cümle ile sonlandırmanız gerekir, aşağıdaki alıntıda gösterildiği gibi.
// 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;
ile ve olmadan group kullanımına into ilişkin daha eksiksiz örnekler bu makalenin Örnek bölümünde verilmiştir.
Grup sorgusunun sonuçlarını numaralandırma
Sorgunun IGrouping<TKey,TElement> ürettiği nesneler group temelde bir liste listesi olduğundan, her gruptaki öğelere erişmek için iç içe foreach döngüsü kullanmanız gerekir. Dış döngü grup anahtarları üzerinde yinelenir ve iç döngü grubun kendisindeki her öğe üzerinde yinelenir. Bir grubun anahtarı olabilir ancak öğe olamaz. Aşağıdaki foreach döngü, önceki kod örneklerinde sorguyu yürütür:
// 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);
}
}
Anahtar türleri
Grup anahtarları dize, yerleşik sayısal tür veya kullanıcı tanımlı adlandırılmış tür veya anonim tür gibi herhangi bir tür olabilir.
Dizeye göre gruplandırma
Önceki kod örnekleri bir char kullandı. Tam soyadı gibi bir dize anahtarı da belirtebilirsiniz:
// 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;
Bool'a göre gruplandırma
Aşağıdaki örnek, sonuçları iki gruba bölmek için bir anahtar için bool değeri kullanır. değeri yan tümcesindeki group bir alt ifadeden gelir.
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
*/
Sayısal aralığa göre gruplandırma
Sonraki örnekte, yüzdebirlik aralığı temsil eden sayısal grup anahtarları oluşturmak için bir ifade kullanılır. Yöntemi çağırma sonucunu depolamak için kullanır let , böylece yöntemini yan tümcesinde group iki kez çağırmanız gerekmez. Sorgu ifadelerinde yöntemleri güvenli bir şekilde kullanma hakkında daha fazla bilgi için bkz . Sorgu ifadelerindeki özel durumları işleme.
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 {temp} and {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
*/
Bileşik anahtarlara göre gruplandırma
Öğeleri birden fazla anahtara göre gruplandırmak istediğinizde bileşik anahtar kullanın. Anahtar öğesini tutmak için anonim bir tür veya adlandırılmış bir tür kullanarak bileşik anahtar oluşturun. Aşağıdaki örnekte, bir sınıfın Person ve cityadlı surname üyeleri olduğunu varsayalım. yan tümcesi group , aynı soyadına ve aynı şehre sahip her bir kişi kümesi için ayrı bir grup oluşturur.
group person by new {name = person.surname, city = person.city};
Sorgu değişkenini başka bir yönteme geçirmeniz gerekiyorsa adlandırılmış bir tür kullanın. Anahtarlar için otomatik olarak uygulanan özelliklere sahip özel bir sınıf oluşturun ve ve yöntemlerini geçersiz kılın EqualsGetHashCode . Ayrıca, bu yöntem geçersiz kılmalarını kesinlikle gerektirmeyen bir yapı da kullanabilirsiniz. Daha fazla bilgi için bkz. Otomatik olarak uygulanan özelliklere sahip basit bir sınıf uygulama ve Dizin ağacında yinelenen dosyaları sorgulama. İkinci makalede, adlandırılmış bir türle bileşik anahtarın nasıl kullanılacağını gösteren bir kod örneği vardır.
Örnekler
Aşağıdaki örnek, gruplara ek sorgu mantığı uygulamadığınızda kaynak verileri gruplara sıralamak için standart deseni gösterir. Bu desen, devamlılık olmadan gruplandırma olarak adlandırılır. Örnek, bir dize dizisindeki öğeleri ilk harflerine göre gruplandırıyor. Sorgunun sonucu, IGrouping<TKey,TElement> türünde ortak bir Key özelliği ve gruplamaya ait her öğeyi içeren bir char koleksiyonu barındıran bir IEnumerable<T> türüdür.
Bir group tümcesinin sonucu birkaç dizinin ardışık dizisidir. Döndürülen her grup içindeki tek tek öğelere erişmek için, aşağıdaki örnekte gösterildiği gibi grup anahtarlarını yineleyen döngü içinde iç içe foreach bir döngü kullanın.
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 '{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
*/
Aşağıdaki örnek, ile intobir devamlılık kullanarak, oluşturduktan sonra gruplar üzerinde nasıl ek mantık gerçekleştirebileceğinizi gösterir. Daha fazla bilgi için bkz. into. Aşağıdaki örnek, yalnızca anahtar değeri sesli harf olan kişileri seçmek için her grubu sorgular.
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: {wordGroup.Key}");
foreach (var word in wordGroup)
{
Console.WriteLine($" {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
*/
Derleme zamanında derleyici, yan tümceleri group yöntemine yapılan çağrılara GroupBy çevirir.
Yan tümce sorgusunun group söz dizimi özel eşitlik karşılaştırıcısını desteklemez. Sorgunuzda kullanmak IEqualityComparer istiyorsanız yöntemini açıkça kullanın GroupBy .
Ayrıca bkz.
GitHub'da bizimle işbirliği yapın
Bu içeriğin kaynağı GitHub'da bulunabilir; burada ayrıca sorunları ve çekme isteklerini oluşturup gözden geçirebilirsiniz. Daha fazla bilgi için katkıda bulunan kılavuzumuzu inceleyin.
