Enumerable.Concat<TSource> 方法

定义

命名空间:

System.Linq

程序集:

System.Linq.dll

Source:

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其方法或在 C# For Each 或 foreach Visual Basic 中使用 来枚举对象之前，不会执行此方法表示的查询。

方法 Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) 与 方法不同， Union 因为 Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) 该方法返回输入序列中的所有原始元素。 方法 Union 仅返回唯一元素。

适用于