Прочитать на английском

Поделиться через


Enumerable.Prepend<TSource>(IEnumerable<TSource>, TSource) Метод

Определение

Добавляет значение в начало последовательности.

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

Параметры типа

TSource

Тип элементов source.

Параметры

source
IEnumerable<TSource>

Последовательность значений.

element
TSource

Значение, которое добавляется в начало source.

Возвращаемое значение

IEnumerable<TSource>

Новая последовательность, которая начиняется с element.

Исключения

source имеет значение null.

Примеры

В следующем примере кода показано, как использовать Prepend для добавления значения в начало последовательности.

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

// Trying to prepend any value of the same type
numbers.Prepend(0);

// 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.Prepend(0)));

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

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

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

Комментарии

Примечание

Этот метод не изменяет элементы коллекции. Вместо этого создается копия коллекции с новым элементом .

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.6, 2.0, 2.1