Enumerable.Append<TSource>(IEnumerable<TSource>, TSource) Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.dll

Quelle:

AppendPrepend.cs

Fügt einen Wert an das Ende der Sequenz an.

C#

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IEnumerable<TSource>

Eine Sequenz von Werten.

element

TSource

Der an source anzufügende Wert.

Gibt zurück

IEnumerable<TSource>

Eine neue Sequenz, die mit element endet.

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie verwenden, Append um einen Wert an das Ende der Sequenz anzufügen.

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

Hinweise

Hinweis

Diese Methode ändert die Elemente der Auflistung nicht. Stattdessen wird eine Kopie der Auflistung mit dem neuen Element erstellt.

Gilt für: