Enumerable.Select Метод

Ссылка

Определение

Пространство имен:: System.Linq

Сборка:: System.Linq.dll

Сборка:: System.Core.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Проецирует каждый элемент последовательности в новую форму.

Перегрузки

Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)	Проецирует каждый элемент последовательности в новую форму.
Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,TResult>)	Проецирует каждый элемент последовательности в новую форму, добавляя индекс элемента.

Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)

Проецирует каждый элемент последовательности в новую форму.

public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TResult> ^ Select(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TResult> ^ selector);

public static System.Collections.Generic.IEnumerable<TResult> Select<TSource,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TResult> selector);

static member Select : seq<'Source> * Func<'Source, 'Result> -> seq<'Result>

<Extension()>
Public Function Select(Of TSource, TResult) (source As IEnumerable(Of TSource), selector As Func(Of TSource, TResult)) As IEnumerable(Of TResult)

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

TSource

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

TResult

Тип значения, возвращаемого функцией selector.

Параметры

source: IEnumerable<TSource>

Последовательность значений, для которых вызывается функция преобразования.

selector: Func<TSource,TResult>

Функция преобразования, применяемая к каждому элементу.

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

IEnumerable<TResult>

Объект IEnumerable<T>, элементы которого получены в результате вызова функции преобразования для каждого элемента последовательности source.

Исключения

ArgumentNullException

Параметр source или selector имеет значение null.

Примеры

В следующем примере кода показано, как использовать Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>) для проецировать последовательность значений.

IEnumerable<int> squares =
    Enumerable.Range(1, 10).Select(x => x * x);

foreach (int num in squares)
{
    Console.WriteLine(num);
}
/*
 This code produces the following output:

 1
 4
 9
 16
 25
 36
 49
 64
 81
 100
*/

' Create a collection of sequential integers
' from 1 to 10 and project their squares.
Dim squares As IEnumerable(Of Integer) =
Enumerable.Range(1, 10).Select(Function(x) x * x)

Dim output As New System.Text.StringBuilder
For Each num As Integer In squares
    output.AppendLine(num)
Next

' Display the output.
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' 1
' 4
' 9
' 16
' 25
' 36
' 49
' 64
' 81
' 100

Этот метод реализуется с помощью отложенного выполнения. Немедленное возвращаемое значение — это объект, в котором хранятся все сведения, необходимые для выполнения действия. Запрос, представленный этим методом, не выполняется до тех пор, пока объект не будет перечислен либо путем вызова метода GetEnumerator напрямую, либо с помощью foreach в Visual C# или For Each в Visual Basic.

Этот метод проекции требует функции преобразования, selectorчтобы создать одно значение для каждого значения в исходной последовательности. source Если selector возвращает значение, которое само по себе является коллекцией, потребитель может вручную пройти по подсезонам. В такой ситуации может оказаться лучше, чтобы запрос возвращал единую объединенную последовательность значений. Для этого используйте SelectMany метод вместо Select. Хотя SelectMany она работает аналогично Select, она отличается тем, что функция преобразования возвращает коллекцию, которая затем расширяется перед возвратом SelectMany .

В синтаксисе выражений select запроса предложение (Visual C#) или Select (Visual Basic) преобразуется в вызов Select.

См. также раздел

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

Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,TResult>)

Проецирует каждый элемент последовательности в новую форму, добавляя индекс элемента.

public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TResult> ^ Select(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int, TResult> ^ selector);

public static System.Collections.Generic.IEnumerable<TResult> Select<TSource,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,TResult> selector);

static member Select : seq<'Source> * Func<'Source, int, 'Result> -> seq<'Result>

<Extension()>
Public Function Select(Of TSource, TResult) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Integer, TResult)) As IEnumerable(Of TResult)

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

TSource

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

TResult

Тип значения, возвращаемого функцией selector.

Параметры

source: IEnumerable<TSource>

Последовательность значений, для которых вызывается функция преобразования.

selector: Func<TSource,Int32,TResult>

Функция преобразования, применяемая к каждому исходному элементу; второй параметр функции представляет индекс исходного элемента.

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

IEnumerable<TResult>

Исключения

ArgumentNullException

Параметр source или selector имеет значение null.

Примеры

В следующем примере кода показано, как использовать Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,TResult>) для проецирования по последовательности значений и использования индекса каждого элемента.

string[] fruits = { "apple", "banana", "mango", "orange",
                      "passionfruit", "grape" };

var query =
    fruits.Select((fruit, index) =>
                      new { index, str = fruit.Substring(0, index) });

foreach (var obj in query)
{
    Console.WriteLine("{0}", obj);
}

/*
 This code produces the following output:

 {index=0, str=}
 {index=1, str=b}
 {index=2, str=ma}
 {index=3, str=ora}
 {index=4, str=pass}
 {index=5, str=grape}
*/

' Create an array of strings.
Dim fruits() As String =
{"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' Project each item in the array to an anonymous type
' that stores the item's index in the array and
' a substring of each item whose length is equal
' to the index position in the original array.
Dim query =
fruits.Select(Function(fruit, index) _
                  New With {index, .Str = fruit.Substring(0, index)})

Dim output As New System.Text.StringBuilder
For Each obj In query
    output.AppendLine(obj.ToString())
Next

' Display the output.
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' { index = 0, Str =  }
' { index = 1, Str = b }
' { index = 2, Str = ma }
' { index = 3, Str = ora }
' { index = 4, Str = pass }
' { index = 5, Str = grape }

Первый аргумент, selector представляющий элемент для обработки. Второй аргумент selector , представляющий отсчитываемый от нуля индекс этого элемента в исходной последовательности. Это может быть полезно, если элементы находятся в известном порядке, и вы хотите сделать что-то с элементом по определенному индексу, например. Это также может быть полезно, если требуется получить индекс одного или нескольких элементов.

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

Enumerable.Select Метод

Определение

Перегрузки

Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)

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

Параметры

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

Исключения

Примеры

Комментарии

См. также раздел

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

Select<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,TResult>)

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

Параметры

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

Исключения

Примеры

Комментарии

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

Дополнительные ресурсы