Enumerable.Concat<TSource> メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.dll

ソース:

Concat.cs

2 つのシーケンスを連結します。

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>

2 つの入力シーケンスの連結された要素が格納されている IEnumerable<T>。

例外

ArgumentNullException

first または second が null です。

例

次のコード例では、 を使用 Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) して 2 つのシーケンスを連結する方法を示します。

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

2 つのシーケンスを連結するもう 1 つの方法は、シーケンスの配列などのコレクションを構築し、 メソッドを SelectMany 適用して ID セレクター関数を渡すことです。 この の使用例を次に 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 または Visual Basic で を使用foreachして列挙されるまで実行されません。

メソッドは Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) 、入力シーケンス内 Union のすべての元の要素を返すの Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) で、 メソッドとは異なります。 メソッドは Union 一意の要素のみを返します。

適用対象