Enumerable.Concat<TSource> Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Source:

Concat.cs

Concatène deux séquences.

C#

public static System.Collections.Generic.IEnumerable<TSource> Concat<TSource> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second);

Paramètres de type

TSource

Type des éléments des séquences d'entrée.

Paramètres

first

IEnumerable<TSource>

Première séquence à concaténer.

second

IEnumerable<TSource>

Séquence à concaténer à la première séquence.

Retours

IEnumerable<TSource>

IEnumerable<T> qui contient les éléments concaténés des deux séquences d'entrée.

Exceptions

ArgumentNullException

first ou second est null.

Exemples

L’exemple de code suivant montre comment utiliser Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) pour concaténer deux séquences.

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

static Pet[] GetCats()
{
    Pet[] cats = { new Pet { Name="Barley", Age=8 },
                   new Pet { Name="Boots", Age=4 },
                   new Pet { Name="Whiskers", Age=1 } };
    return cats;
}

static Pet[] GetDogs()
{
    Pet[] dogs = { new Pet { Name="Bounder", Age=3 },
                   new Pet { Name="Snoopy", Age=14 },
                   new Pet { Name="Fido", Age=9 } };
    return dogs;
}

public static void ConcatEx1()
{
    Pet[] cats = GetCats();
    Pet[] dogs = GetDogs();

    IEnumerable<string> query =
        cats.Select(cat => cat.Name).Concat(dogs.Select(dog => dog.Name));

    foreach (string name in query)
    {
        Console.WriteLine(name);
    }
}

// This code produces the following output:
//
// Barley
// Boots
// Whiskers
// Bounder
// Snoopy
// Fido

Une autre façon de concaténer deux séquences consiste à construire une collection, par exemple un tableau, de séquences, puis à appliquer la SelectMany méthode, en lui transmettant la fonction de sélecteur d’identité. L’exemple suivant illustre cette utilisation de SelectMany.

C#

Pet[] cats = GetCats();
Pet[] dogs = GetDogs();

IEnumerable<string> query =
    new[] { cats.Select(cat => cat.Name), dogs.Select(dog => dog.Name) }
    .SelectMany(name => name);

foreach (string name in query)
{
    Console.WriteLine(name);
}

// This code produces the following output:
//
// Barley
// Boots
// Whiskers
// Bounder
// Snoopy
// Fido

Remarques

Cette méthode est implémentée à l’aide d’une exécution différée. La valeur de retour immédiat est un objet qui stocke toutes les informations nécessaires à l’exécution de l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré soit en appelant directement sa GetEnumerator méthode, soit en utilisant foreach en C# ou For Each en Visual Basic.

La Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) méthode diffère de la Union méthode, car la Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) méthode retourne tous les éléments d’origine dans les séquences d’entrée. La Union méthode retourne uniquement des éléments uniques.

S’applique à