Enumerable.Concat<TSource> Metoda

Definicja

Przestrzeń nazw:

System.Linq

Zestaw:

System.Linq.dll

Źródło:

Concat.cs

Łączy dwie sekwencje.

C#

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

Parametry typu

TSource

Typ elementów sekwencji wejściowych.

Parametry

first

IEnumerable<TSource>

Pierwsza sekwencja do połączenia.

second

IEnumerable<TSource>

Sekwencja, która ma być połączona z pierwszą sekwencją.

Zwraca

IEnumerable<TSource>

Element IEnumerable<T> zawierający łączone elementy dwóch sekwencji wejściowych.

Wyjątki

ArgumentNullException

first lub second ma wartość null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) metody łączenia dwóch sekwencji.

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

Alternatywnym sposobem łączenia dwóch sekwencji jest utworzenie kolekcji, na przykład tablicy, sekwencji, a następnie zastosowanie SelectMany metody, przekazując ją do funkcji selektora tożsamości. W poniższym przykładzie pokazano użycie metody 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

Uwagi

Ta metoda jest implementowana za pomocą odroczonego wykonania. Bezpośrednio zwracana wartość jest obiektem, który przechowuje wszystkie informacje wymagane do wykonania akcji. Zapytanie reprezentowane przez tę metodę nie jest wykonywane, dopóki obiekt nie zostanie wyliczone przez wywołanie metody GetEnumerator bezpośrednio lub przy użyciu foreach języka C# lub For Each w Visual Basic.

Metoda Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) różni się od Union metody, ponieważ Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) metoda zwraca wszystkie oryginalne elementy w sekwencjach wejściowych. Metoda Union zwraca tylko unikatowe elementy.

Dotyczy