Queryable.Select 方法

定義

命名空間:

System.Linq

組件:

netstandard.dll, System.Linq.Queryable.dll

將序列的每個專案投影成新的表單。

多載

名稱	Description
Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>)	藉由合併元素的索引，將序列的每個專案投影成新的表單。
Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>)	將序列的每個專案投影成新的表單。

Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>)

來源:

Queryable.cs

藉由合併元素的索引，將序列的每個專案投影成新的表單。

public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TResult> ^ Select(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, int, TResult> ^> ^ selector);

public static System.Linq.IQueryable<TResult> Select<TSource,TResult>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,int,TResult>> selector);

static member Select : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, int, 'Result>> -> System.Linq.IQueryable<'Result>

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

類型參數

TSource

元素 source的類型。

TResult

由 所代表 selector的函數回傳的值型別。

參數

source

IQueryable<TSource>

一連串的價值要投射。

selector

Expression<Func<TSource,Int32,TResult>>

一個投影函數，可以套用到每個元素。

傳回

IQueryable<TResult>

一個 IQueryable<T> 元素是對每個 source元素調用投影函數所產生的結果。

例外狀況

ArgumentNullException

source 或 selector 為 null。

範例

以下程式碼範例示範如何對 Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>) 一串數值進行投影，並使用投影形式中每個元素的索引。

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

// Project an anonymous type that contains the
// index of the string in the source array, and
// a string that contains the same number of characters
// as the string's index in the source array.
var query =
    fruits.AsQueryable()
    .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 }
*/

Dim fruits() As String = {"apple", "banana", "mango", "orange", _
                      "passionfruit", "grape"}

' Project an anonymous type that contains the
' index of the string in the source array, and
' a string that contains the same number of characters
' as the string's index in the source array.
Dim query = _
    fruits.AsQueryable() _
    .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.
MsgBox(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 }

備註

此方法至少有一個型別 Expression<TDelegate> 參數，其型別參數的參數是其中一個 Func<T,TResult> 型別。 對於這些參數，你可以輸入 lambda 運算式，然後它會被編譯成 Expression<TDelegate>。

該 Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>) 方法產生的 是 MethodCallExpression ，代表 Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>) 呼叫本身為一個構造化的泛型方法。 接著將 傳遞MethodCallExpression給CreateQuery(Expression)IQueryProvider由參數Provider性質source所表示的方法。

執行代表呼叫 Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>) 的表達式樹所產生的查詢行為，取決於參數型別 source 的實作。 預期的行為是它會 selector 對 的 source 每個元素進行調用，將其投射成不同的形式。

Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>)

來源:

Queryable.cs

將序列的每個專案投影成新的表單。

public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TResult> ^ Select(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TResult> ^> ^ selector);

public static System.Linq.IQueryable<TResult> Select<TSource,TResult>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TResult>> selector);

static member Select : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Result>> -> System.Linq.IQueryable<'Result>

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

類型參數

TSource

元素 source的類型。

TResult

由 所代表 selector的函數回傳的值型別。

參數

source

IQueryable<TSource>

一連串的價值要投射。

selector

Expression<Func<TSource,TResult>>

一個投影函數，可以套用到每個元素。

傳回

IQueryable<TResult>

一個 IQueryable<T> 元素是對每個 source元素調用投影函數所產生的結果。

例外狀況

ArgumentNullException

source 或 selector 為 null。

範例

以下程式碼範例示範如何對 Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) 一連串值進行投影。

List<int> range =
    new List<int> { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };

// Project the square of each int value.
IEnumerable<int> squares =
    range.AsQueryable().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
*/

Dim range As New List(Of Integer)(New Integer() {1, 2, 3, 4, 5, 6, 7, 8, 9, 10})

' Project the square of each int value.
Dim squares As IEnumerable(Of Integer) = _
    range.AsQueryable().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.
MsgBox(output.ToString())

' This code produces the following output:

' 1
' 4
' 9
' 16
' 25
' 36
' 49
' 64
' 81
' 100

備註

此方法至少有一個型別 Expression<TDelegate> 參數，其型別參數的參數是其中一個 Func<T,TResult> 型別。 對於這些參數，你可以輸入 lambda 運算式，然後它會被編譯成 Expression<TDelegate>。

該 Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) 方法產生的 是 MethodCallExpression ，代表 Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) 呼叫本身為一個構造化的泛型方法。 接著將 傳遞MethodCallExpression給CreateQuery(Expression)IQueryProvider由參數Provider性質source所表示的方法。

執行代表呼叫 Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) 的表達式樹所產生的查詢行為，取決於參數型別 source 的實作。 預期的行為是它會 selector 對 的 source 每個元素進行調用，將其投射成不同的形式。