Queryable.Select Méthode

Définition

Projette chaque élément d’une séquence dans un nouveau formulaire.

Surcharges

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

Projette chaque élément d'une séquence dans un nouveau formulaire en incorporant l'index de l'élément.

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

Projette chaque élément d’une séquence dans un nouveau formulaire.

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

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Projette chaque élément d'une séquence dans un nouveau formulaire en incorporant l'index de l'élément.

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)

Paramètres de type

TSource

Le type des éléments de source.

TResult

Type de la valeur retournée par la fonction représentée par selector.

Paramètres

source
IQueryable<TSource>

Séquence de valeurs à projeter.

selector
Expression<Func<TSource,Int32,TResult>>

Fonction de projection à appliquer à chaque élément.

Retours

IQueryable<TResult>

IQueryable<T> dont les éléments sont le résultat de l'appel d'une fonction de projection sur chaque élément de source.

Exceptions

source ou selector est null.

Exemples

L’exemple de code suivant montre comment utiliser pour projeter Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>) sur une séquence de valeurs et utiliser l’index de chaque élément dans le formulaire projeté.

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 }

Remarques

Cette méthode a au moins un paramètre de type Expression<TDelegate> dont l’argument type est l’un Func<T,TResult> des types. Pour ces paramètres, vous pouvez passer une expression lambda et elle sera compilée dans un Expression<TDelegate>.

La Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>) méthode génère un MethodCallExpression qui représente l’appel Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>) de lui-même en tant que méthode générique construite. Il passe ensuite le MethodCallExpression à la CreateQuery(Expression) méthode du IQueryProvider représenté par la Provider propriété du source paramètre .

Le comportement de requête qui se produit à la suite de l’exécution d’une arborescence d’expressions qui représente l’appel Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,TResult>>) dépend de l’implémentation du type du source paramètre. Le comportement attendu est qu’il appelle selector sur chaque élément de source pour le projeter sous une forme différente.

S’applique à

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

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Projette chaque élément d’une séquence dans un nouveau formulaire.

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)

Paramètres de type

TSource

Le type des éléments de source.

TResult

Type de la valeur retournée par la fonction représentée par selector.

Paramètres

source
IQueryable<TSource>

Séquence de valeurs à projeter.

selector
Expression<Func<TSource,TResult>>

Fonction de projection à appliquer à chaque élément.

Retours

IQueryable<TResult>

IQueryable<T> dont les éléments sont le résultat de l'appel d'une fonction de projection sur chaque élément de source.

Exceptions

source ou selector est null.

Exemples

L’exemple de code suivant montre comment utiliser pour projeter Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) une séquence de valeurs.

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

Remarques

Cette méthode a au moins un paramètre de type Expression<TDelegate> dont l’argument type est l’un Func<T,TResult> des types. Pour ces paramètres, vous pouvez passer une expression lambda et elle sera compilée dans un Expression<TDelegate>.

La Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) méthode génère un MethodCallExpression qui représente l’appel Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) de lui-même en tant que méthode générique construite. Il passe ensuite le MethodCallExpression à la CreateQuery(Expression) méthode du IQueryProvider représenté par la Provider propriété du source paramètre .

Le comportement de requête qui se produit à la suite de l’exécution d’une arborescence d’expressions qui représente l’appel Select<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) dépend de l’implémentation du type du source paramètre. Le comportement attendu est qu’il appelle selector sur chaque élément de source pour le projeter sous une forme différente.

S’applique à