Enumerable.Append<TSource>(IEnumerable<TSource>, TSource) Método
Definição
Acrescenta um valor ao final da sequência.Appends a value to the end of the sequence.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TSource> ^ Append(System::Collections::Generic::IEnumerable<TSource> ^ source, TSource element);
public static System.Collections.Generic.IEnumerable<TSource> Append<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource element);
static member Append : seq<'Source> * 'Source -> seq<'Source>
<Extension()>
Public Function Append(Of TSource) (source As IEnumerable(Of TSource), element As TSource) As IEnumerable(Of TSource)
Parâmetros de tipo
- TSource
O tipo dos elementos de source
.The type of the elements of source
.
Parâmetros
- source
- IEnumerable<TSource>
Uma sequência de valores.A sequence of values.
- element
- TSource
O valor a ser acrescentado a source
.The value to append to source
.
Retornos
- IEnumerable<TSource>
Uma nova sequência que termina com element
.A new sequence that ends with element
.
Exceções
source
é null
.source
is null
.
Exemplos
O exemplo de código a seguir demonstra como usar o Append para acrescentar um valor ao final da sequência.The following code example demonstrates how to use Append to append a value to the end of the sequence.
// 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
' Creating a list of numbers
Dim numbers As New List(Of Integer)(New Integer() {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
Dim newNumbers As List(Of Integer) = 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
Comentários
Observação
Esse método não modifica os elementos da coleção.This method does not modify the elements of the collection. Em vez disso, ele cria uma cópia da coleção com o novo elemento.Instead, it creates a copy of the collection with the new element.