LINQ en verzamelingen

De meeste verzamelingen modelleren een reeks elementen. U kunt LINQ gebruiken om een query uit te voeren op elk verzamelingstype. Andere LINQ-methoden zoeken elementen in een verzameling, rekenwaarden uit de elementen in een verzameling of wijzigen van de verzameling of de bijbehorende elementen. Deze voorbeelden helpen u meer te weten te komen over LINQ-methoden en hoe u deze kunt gebruiken met uw verzamelingen of andere gegevensbronnen.

Het ingestelde verschil tussen twee lijsten zoeken

In dit voorbeeld ziet u hoe u LINQ gebruikt om twee lijsten met tekenreeksen te vergelijken en deze regels uit te voeren die zich in de eerste verzameling bevinden, maar niet in de tweede. De eerste verzameling namen wordt opgeslagen in het bestand names1.txt:

Bankov, Peter
Holm, Michael
Garcia, Hugo
Potra, Cristina
Noriega, Fabricio
Aw, Kam Foo
Beebe, Ann
Toyoshima, Tim
Guy, Wey Yuan
Garcia, Debra

De tweede verzameling namen wordt opgeslagen in het bestand names2.txt. Sommige namen worden in beide volgorden weergegeven.

Liu, Jinghao
Bankov, Peter
Holm, Michael
Garcia, Hugo
Beebe, Ann
Gilchrist, Beth
Myrcha, Jacek
Giakoumakis, Leo
McLin, Nkenge
El Yassir, Mehdi

De volgende code laat zien hoe u de Enumerable.Except methode kunt gebruiken om elementen te vinden in de eerste lijst die zich niet in de tweede lijst bevindt:

// Create the IEnumerable data sources.
string[] names1 = File.ReadAllLines("names1.txt");
string[] names2 = File.ReadAllLines("names2.txt");

// Create the query. Note that method syntax must be used here.
var differenceQuery = names1.Except(names2);

// Execute the query.
Console.WriteLine("The following lines are in names1.txt but not names2.txt");
foreach (string s in differenceQuery)
    Console.WriteLine(s);
/* Output:
 The following lines are in names1.txt but not names2.txt
 Potra, Cristina
 Noriega, Fabricio
 Aw, Kam Foo
 Toyoshima, Tim
 Guy, Wey Yuan
 Garcia, Debra
 */

Sommige typen querybewerkingen, zoals Except, Distinct, Unionen Concat, kunnen alleen worden uitgedrukt in syntaxis op basis van methoden.

Tekenreeksverzamelingen combineren en vergelijken

In dit voorbeeld ziet u hoe u bestanden met regels tekst samenvoegt en vervolgens de resultaten sorteert. In het bijzonder ziet u hoe u een samenvoeging, een samenvoeging en een snijpunt kunt uitvoeren op de twee sets tekstregels. In het voorgaande voorbeeld worden dezelfde twee tekstbestanden gebruikt. De code toont voorbeelden van de Enumerable.Concat, Enumerable.Unionen Enumerable.Except.

//Put text files in your solution folder
string[] fileA = File.ReadAllLines("names1.txt");
string[] fileB = File.ReadAllLines("names2.txt");

//Simple concatenation and sort. Duplicates are preserved.
var concatQuery = fileA.Concat(fileB).OrderBy(s => s);

// Pass the query variable to another function for execution.
OutputQueryResults(concatQuery, "Simple concatenate and sort. Duplicates are preserved:");

// Concatenate and remove duplicate names based on
// default string comparer.
var uniqueNamesQuery = fileA.Union(fileB).OrderBy(s => s);
OutputQueryResults(uniqueNamesQuery, "Union removes duplicate names:");

// Find the names that occur in both files (based on
// default string comparer).
var commonNamesQuery = fileA.Intersect(fileB);
OutputQueryResults(commonNamesQuery, "Merge based on intersect:");

// Find the matching fields in each list. Merge the two
// results by using Concat, and then
// sort using the default string comparer.
string nameMatch = "Garcia";

var tempQuery1 = from name in fileA
                 let n = name.Split(',')
                 where n[0] == nameMatch
                 select name;

var tempQuery2 = from name2 in fileB
                 let n2 = name2.Split(',')
                 where n2[0] == nameMatch
                 select name2;

var nameMatchQuery = tempQuery1.Concat(tempQuery2).OrderBy(s => s);
OutputQueryResults(nameMatchQuery, $"""Concat based on partial name match "{nameMatch}":""");

static void OutputQueryResults(IEnumerable<string> query, string message)
{
    Console.WriteLine(Environment.NewLine + message);
    foreach (string item in query)
    {
        Console.WriteLine(item);
    }
    Console.WriteLine($"{query.Count()} total names in list");
}
/* Output:
    Simple concatenate and sort. Duplicates are preserved:
    Aw, Kam Foo
    Bankov, Peter
    Bankov, Peter
    Beebe, Ann
    Beebe, Ann
    El Yassir, Mehdi
    Garcia, Debra
    Garcia, Hugo
    Garcia, Hugo
    Giakoumakis, Leo
    Gilchrist, Beth
    Guy, Wey Yuan
    Holm, Michael
    Holm, Michael
    Liu, Jinghao
    McLin, Nkenge
    Myrcha, Jacek
    Noriega, Fabricio 
    Potra, Cristina
    Toyoshima, Tim
    20 total names in list

    Union removes duplicate names:
    Aw, Kam Foo
    Bankov, Peter
    Beebe, Ann
    El Yassir, Mehdi
    Garcia, Debra
    Garcia, Hugo
    Giakoumakis, Leo
    Gilchrist, Beth
    Guy, Wey Yuan
    Holm, Michael
    Liu, Jinghao
    McLin, Nkenge
    Myrcha, Jacek
    Noriega, Fabricio
    Potra, Cristina
    Toyoshima, Tim
    16 total names in list

    Merge based on intersect:
    Bankov, Peter
    Holm, Michael
    Garcia, Hugo
    Beebe, Ann
    4 total names in list

    Concat based on partial name match "Garcia":
    Garcia, Debra
    Garcia, Hugo
    Garcia, Hugo
    3 total names in list
*/

Objectverzamelingen uit meerdere bronnen vullen

In dit voorbeeld ziet u hoe u gegevens uit verschillende bronnen kunt samenvoegen in een reeks nieuwe typen.

Notitie

Probeer geen gegevens of gegevens in het bestandssysteem samen te voegen met gegevens die zich nog in een database bevinden. Dergelijke joins tussen domeinen kunnen niet-gedefinieerde resultaten opleveren vanwege verschillende manieren waarop joinbewerkingen kunnen worden gedefinieerd voor databasequery's en andere typen bronnen. Daarnaast bestaat er een risico dat een dergelijke bewerking kan leiden tot een uitzondering buiten het geheugen als de hoeveelheid gegevens in de database groot genoeg is. Als u gegevens uit een database wilt samenvoegen met in-memory gegevens, roept ToList u eerst de databasequery aan of ToArray voert u de join uit op de geretourneerde verzameling.

In dit voorbeeld worden twee bestanden gebruikt. De eerste, names.csv, bevat namen van leerlingen/studenten en student-id's.

Omelchenko,Svetlana,111
O'Donnell,Claire,112
Mortensen,Sven,113
Garcia,Cesar,114
Garcia,Debra,115
Fakhouri,Fadi,116
Feng,Hanying,117
Garcia,Hugo,118
Tucker,Lance,119
Adams,Terry,120
Zabokritski,Eugene,121
Tucker,Michael,122

De tweede, scores.csv, bevat student-id's in de eerste kolom, gevolgd door examenscores.

111, 97, 92, 81, 60
112, 75, 84, 91, 39
113, 88, 94, 65, 91
114, 97, 89, 85, 82
115, 35, 72, 91, 70
116, 99, 86, 90, 94
117, 93, 92, 80, 87
118, 92, 90, 83, 78
119, 68, 79, 88, 92
120, 99, 82, 81, 79
121, 96, 85, 91, 60
122, 94, 92, 91, 91

In het volgende voorbeeld ziet u hoe u een benoemde record Student gebruikt om samengevoegde gegevens op te slaan uit twee in-memory verzamelingen tekenreeksen die spreadsheetgegevens simuleren in .csv indeling. De id wordt gebruikt als sleutel om leerlingen/studenten toe te wijzen aan hun scores.

// Each line of names.csv consists of a last name, a first name, and an
// ID number, separated by commas. For example, Omelchenko,Svetlana,111
string[] names = File.ReadAllLines("names.csv");

// Each line of scores.csv consists of an ID number and four test
// scores, separated by commas. For example, 111, 97, 92, 81, 60
string[] scores = File.ReadAllLines("scores.csv");

// Merge the data sources using a named type.
// var could be used instead of an explicit type. Note the dynamic
// creation of a list of ints for the ExamScores member. The first item
// is skipped in the split string because it is the student ID,
// not an exam score.
IEnumerable<Student> queryNamesScores = from nameLine in names
                                        let splitName = nameLine.Split(',')
                                        from scoreLine in scores
                                        let splitScoreLine = scoreLine.Split(',')
                                        where Convert.ToInt32(splitName[2]) == Convert.ToInt32(splitScoreLine[0])
                                        select new Student
                                        (
                                            FirstName: splitName[0],
                                            LastName: splitName[1],
                                            ID: Convert.ToInt32(splitName[2]),
                                            ExamScores: (from scoreAsText in splitScoreLine.Skip(1)
                                                         select Convert.ToInt32(scoreAsText)
                                                        ).ToArray()
                                        );

// Optional. Store the newly created student objects in memory
// for faster access in future queries. This could be useful with
// very large data files.
List<Student> students = queryNamesScores.ToList();

// Display each student's name and exam score average.
foreach (var student in students)
{
    Console.WriteLine($"The average score of {student.FirstName} {student.LastName} is {student.ExamScores.Average()}.");
}
/* Output:
The average score of Omelchenko Svetlana is 82.5.
The average score of O'Donnell Claire is 72.25.
The average score of Mortensen Sven is 84.5.
The average score of Garcia Cesar is 88.25.
The average score of Garcia Debra is 67.
The average score of Fakhouri Fadi is 92.25.
The average score of Feng Hanying is 88.
The average score of Garcia Hugo is 85.75.
The average score of Tucker Lance is 81.75.
The average score of Adams Terry is 85.25.
The average score of Zabokritski Eugene is 83.
The average score of Tucker Michael is 92.
*/

In de select-component wordt elk nieuw Student object geïnitialiseerd op basis van de gegevens in de twee bronnen.

Als u de resultaten van een query niet hoeft op te slaan, kunnen tuples of anonieme typen handiger zijn dan benoemde typen. In het volgende voorbeeld wordt dezelfde taak uitgevoerd als in het vorige voorbeeld, maar worden tuples gebruikt in plaats van benoemde typen:

// Merge the data sources by using an anonymous type.
// Note the dynamic creation of a list of ints for the
// ExamScores member. We skip 1 because the first string
// in the array is the student ID, not an exam score.
var queryNamesScores2 = from nameLine in names
                        let splitName = nameLine.Split(',')
                        from scoreLine in scores
                        let splitScoreLine = scoreLine.Split(',')
                        where Convert.ToInt32(splitName[2]) == Convert.ToInt32(splitScoreLine[0])
                        select (FirstName: splitName[0], 
                                LastName: splitName[1], 
                                ExamScores: (from scoreAsText in splitScoreLine.Skip(1)
                                             select Convert.ToInt32(scoreAsText))
                                             .ToList()
                               );

// Display each student's name and exam score average.
foreach (var student in queryNamesScores2)
{
    Console.WriteLine($"The average score of {student.FirstName} {student.LastName} is {student.ExamScores.Average()}.");
}

Een query uitvoeren op een matrixlijst met LINQ

Wanneer u LINQ gebruikt om query's uit te voeren op niet-gegenereerde IEnumerable verzamelingen, zoals ArrayList, moet u expliciet het type van de bereikvariabele declareren om het specifieke type van de objecten in de verzameling weer te geven. Als u een ArrayList object Student hebt, moet uw from-component er als volgt uitzien:

var query = from Student s in arrList
//...

Door het type bereikvariabele op te geven, cast u elk item in het ArrayList item naar een Student.

Het gebruik van een expliciet getypte bereikvariabele in een query-expressie komt overeen met het aanroepen van de Cast methode. Cast genereert een uitzondering als de opgegeven cast niet kan worden uitgevoerd. Cast en OfType zijn de twee standaardqueryoperatormethoden die op niet-genrische IEnumerable typen werken. Zie Typerelaties in LINQ-querybewerkingen voor meer informatie. In het volgende voorbeeld ziet u een query boven een ArrayList.

ArrayList arrList = new ArrayList();
arrList.Add(
    new Student
    (
        FirstName: "Svetlana",
        LastName: "Omelchenko",
        ExamScores: new int[] { 98, 92, 81, 60 }
    ));
arrList.Add(
    new Student
    (
        FirstName: "Claire",
        LastName: "O’Donnell",
        ExamScores: new int[] { 75, 84, 91, 39 }
    ));
arrList.Add(
    new Student
    (
        FirstName: "Sven",
        LastName: "Mortensen",
        ExamScores: new int[] { 88, 94, 65, 91 }
    ));
arrList.Add(
    new Student
    (
        FirstName: "Cesar",
        LastName: "Garcia",
        ExamScores: new int[] { 97, 89, 85, 82 }
    ));

var query = from Student student in arrList
            where student.ExamScores[0] > 95
            select student;

foreach (Student s in query)
    Console.WriteLine(s.LastName + ": " + s.ExamScores[0]);