Enumerable.Concat<TSource> Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Исходный код:

Concat.cs

Объединяет две последовательности.

C#

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

Параметры типа

TSource

Тип элементов входных последовательностей.

Параметры

first

IEnumerable<TSource>

Первая из объединяемых последовательностей.

second

IEnumerable<TSource>

Последовательность, объединяемая с первой последовательностью.

Возвращаемое значение

IEnumerable<TSource>

Объект IEnumerable<T>, содержащий объединенные элементы двух входных последовательностей.

Исключения

ArgumentNullException

Параметр first или second имеет значение null.

Примеры

В следующем примере кода показано, как использовать Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) для объединения двух последовательностей.

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

Альтернативным способом объединения двух последовательностей является создание коллекции, например массива, последовательностей, а затем применение SelectMany метода, передав ему функцию селектора удостоверений. В следующем примере показано использование 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

Комментарии

Этот метод реализуется с помощью отложенного выполнения. Немедленно возвращаемое значение — это объект, в котором хранятся все сведения, необходимые для выполнения действия. Запрос, представленный этим методом, не выполняется до тех пор, пока объект не будет перечислен либо путем вызова его GetEnumerator метода напрямую, либо с помощью foreach в C# или For Each в Visual Basic.

Метод Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) отличается от метода тем, Union что Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) метод возвращает все исходные элементы во входных последовательностях. Метод Union возвращает только уникальные элементы.

Применяется к