Enumerable.Concat<TSource> Metodo

Definizione

Spazio dei nomi:

System.Linq

Assembly:

System.Linq.dll

Origine:

Concat.cs

Concatena due sequenze.

C#

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

Parametri di tipo

TSource

Tipo degli elementi delle sequenze di input.

Parametri

first

IEnumerable<TSource>

Prima sequenza da concatenare.

second

IEnumerable<TSource>

Sequenza da concatenare alla prima sequenza.

Restituisce

IEnumerable<TSource>

Un oggetto IEnumerable<T> che contiene gli elementi concatenati delle due sequenze di input.

Eccezioni

ArgumentNullException

first o second è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) per concatenare due sequenze.

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

Un modo alternativo per concatenare due sequenze consiste nel costruire una raccolta, ad esempio una matrice, di sequenze e quindi applicare il SelectMany metodo, passando la funzione selettore di identità. Nell'esempio seguente viene illustrato l'uso di 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

Commenti

Questo metodo viene implementato usando l'esecuzione posticipata. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato chiamando il GetEnumerator relativo metodo direttamente o usando foreach in C# o For Each in Visual Basic.

Il Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) metodo differisce dal Union metodo perché il Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) metodo restituisce tutti gli elementi originali nelle sequenze di input. Il Union metodo restituisce solo elementi univoci.

Si applica a