Enumerable.Append<TSource>(IEnumerable<TSource>, TSource) メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.dll

ソース:

AppendPrepend.cs

シーケンスの末尾に値を追加します。

C#

public static System.Collections.Generic.IEnumerable<TSource> Append<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource element);

型パラメーター

TSource

source の要素の型。

パラメーター

source

IEnumerable<TSource>

値のシーケンス。

element

TSource

source に追加する値。

戻り値

IEnumerable<TSource>

element で終わる新しいシーケンス。

例外

ArgumentNullException

source が nullです。

例

次のコード例では、 を使用 Append してシーケンスの末尾に値を追加する方法を示します。

C#

// Creating a list of numbers
List<int> numbers = new List<int> { 1, 2, 3, 4 };

// Trying to append any value of the same type
numbers.Append(5);

// It doesn't work because the original list has not been changed
Console.WriteLine(string.Join(", ", numbers));

// It works now because we are using a changed copy of the original list
Console.WriteLine(string.Join(", ", numbers.Append(5)));

// If you prefer, you can create a new list explicitly
List<int> newNumbers = numbers.Append(5).ToList();

// And then write to the console output
Console.WriteLine(string.Join(", ", newNumbers));

// This code produces the following output:
//
// 1, 2, 3, 4
// 1, 2, 3, 4, 5
// 1, 2, 3, 4, 5

注釈

注意

このメソッドは、コレクションの要素を変更しません。 代わりに、新しい要素を使用してコレクションのコピーを作成します。

適用対象