Expression<TDelegate> Classe

Définition

Représente une expression lambda fortement typée comme une structure de données sous forme d'arborescence de l'expression.Represents a strongly typed lambda expression as a data structure in the form of an expression tree. Cette classe ne peut pas être héritée.This class cannot be inherited.

generic <typename TDelegate>
public ref class Expression sealed : System::Linq::Expressions::LambdaExpression
public sealed class Expression<TDelegate> : System.Linq.Expressions.LambdaExpression
type Expression<'Delegate> = class
    inherit LambdaExpression
Public NotInheritable Class Expression(Of TDelegate)
Inherits LambdaExpression

Paramètres de type

TDelegate

Type du délégué représenté par le Expression<TDelegate>.The type of the delegate that the Expression<TDelegate> represents.

Héritage
Expression<TDelegate>

Exemples

L’exemple de code suivant montre comment représenter une expression lambda à la fois en tant que code exécutable sous la forme d’un délégué et en tant que données sous la forme d’une arborescence de l’expression.The following code example demonstrates how to represent a lambda expression both as executable code in the form of a delegate and as data in the form of an expression tree. Il montre également comment réactiver l’arborescence de l’expression en code exécutable à l' Compile aide de la méthode.It also demonstrates how to turn the expression tree back into executable code by using the Compile method.


// Lambda expression as executable code.
Func<int, bool> deleg = i => i < 5;
// Invoke the delegate and display the output.
Console.WriteLine("deleg(4) = {0}", deleg(4));

// Lambda expression as data in the form of an expression tree.
System.Linq.Expressions.Expression<Func<int, bool>> expr = i => i < 5;
// Compile the expression tree into executable code.
Func<int, bool> deleg2 = expr.Compile();
// Invoke the method and print the output.
Console.WriteLine("deleg2(4) = {0}", deleg2(4));

/*  This code produces the following output:

    deleg(4) = True
    deleg2(4) = True
*/


' Lambda expression as executable code.
Dim deleg As Func(Of Integer, Boolean) = Function(ByVal i) i < 5
' Invoke the delegate and display the output.
MsgBox(String.Format("deleg(4) = {0}", deleg(4)))

' Lambda expression as data in the form of an expression tree.
Dim expr As System.Linq.Expressions.Expression(Of Func(Of Integer, Boolean)) = Function(ByVal i) i < 5
' Compile the expression tree into executable code.
Dim deleg2 As Func(Of Integer, Boolean) = expr.Compile()
' Invoke the method and print the output.
MsgBox(String.Format("deleg2(4) = {0}", deleg2(4)))

' This code produces the following output:
'
' deleg(4) = True
' deleg2(4) = True

Remarques

Quand une expression lambda est assignée à une variable, un champ ou un paramètre Expression<TDelegate>dont le type est, le compilateur émet des instructions pour générer une arborescence de l’expression.When a lambda expression is assigned to a variable, field, or parameter whose type is Expression<TDelegate>, the compiler emits instructions to build an expression tree.

Notes

Une conversion d’une expression lambda en type Expression<D> (Expression(Of D) dans Visual Basic) existe si une conversion de l’expression lambda en un délégué de type D existe.A conversion from a lambda expression to type Expression<D> (Expression(Of D) in Visual Basic) exists if a conversion from the lambda expression to a delegate of type D exists. Toutefois, la conversion peut échouer, par exemple, si le corps de l’expression lambda est un bloc.However, the conversion may fail, for example, if the body of the lambda expression is a block. Cela signifie que les délégués et les arborescences d’expressions se comportent de la même façon que la résolution de surcharge.This means that delegates and expression trees behave similarly with regard to overload resolution.

L’arborescence d’expressions est une représentation de données en mémoire de l’expression lambda.The expression tree is an in-memory data representation of the lambda expression. L’arborescence d’expressions rend la structure de l’expression lambda transparente et explicite.The expression tree makes the structure of the lambda expression transparent and explicit. Vous pouvez interagir avec les données de l’arborescence d’expression comme vous le feriez avec toute autre structure de données.You can interact with the data in the expression tree just as you can with any other data structure.

La possibilité de traiter des expressions en tant que structures de données permet aux API de recevoir du code utilisateur dans un format qui peut être inspecté, transformé et traité de manière personnalisée.The ability to treat expressions as data structures enables APIs to receive user code in a format that can be inspected, transformed, and processed in a custom manner. Par exemple, l' LINQ to SQLLINQ to SQL implémentation de l’accès aux données utilise cette fonction pour convertir les arborescences d’expressions en instructions Transact-SQL qui peuvent être évaluées par la base de données.For example, the LINQ to SQLLINQ to SQL data access implementation uses this facility to translate expression trees to Transact-SQL statements that can be evaluated by the database.

De nombreux opérateurs de requête standard définis Queryable dans la classe ont un ou plusieurs paramètres Expression<TDelegate>de type.Many standard query operators defined in the Queryable class have one or more parameters of type Expression<TDelegate>.

Le NodeType d’un Expression<TDelegate> est Lambda.The NodeType of an Expression<TDelegate> is Lambda.

Utilisez la Lambda<TDelegate>(Expression, IEnumerable<ParameterExpression>) méthode Lambda<TDelegate>(Expression, ParameterExpression[]) ou pour créer un Expression<TDelegate> objet.Use the Lambda<TDelegate>(Expression, IEnumerable<ParameterExpression>) or Lambda<TDelegate>(Expression, ParameterExpression[]) method to create an Expression<TDelegate> object.

Propriétés

Body

Obtient le corps de l'expression lambda.Gets the body of the lambda expression.

(Hérité de LambdaExpression)
CanReduce

Indique que le nœud peut être réduit à un nœud plus simple.Indicates that the node can be reduced to a simpler node. Si la valeur retournée est true, Reduce() peut être appelé pour produire la forme réduite.If this returns true, Reduce() can be called to produce the reduced form.

(Hérité de Expression)
Name

Obtient le nom de l'expression lambda.Gets the name of the lambda expression.

(Hérité de LambdaExpression)
NodeType

Retourne le type de nœud de cet objet Expression.Returns the node type of this Expression.

(Hérité de LambdaExpression)
Parameters

Obtient les paramètres de l'expression lambda.Gets the parameters of the lambda expression.

(Hérité de LambdaExpression)
ReturnType

Obtient le type de retour de l'expression lambda.Gets the return type of the lambda expression.

(Hérité de LambdaExpression)
TailCall

Obtient la valeur qui indique si l'expression lambda doit être compilée avec l'optimisation d'appel tail.Gets the value that indicates if the lambda expression will be compiled with the tail call optimization.

(Hérité de LambdaExpression)
Type

Obtient le type statique de l'expression que ce Expression représente.Gets the static type of the expression that this Expression represents.

(Hérité de LambdaExpression)

Méthodes

Accept(ExpressionVisitor)

Distribue à la méthode de visite spécifique à ce type de nœud.Dispatches to the specific visit method for this node type. Par exemple, MethodCallExpression appelle VisitMethodCall(MethodCallExpression).For example, MethodCallExpression calls the VisitMethodCall(MethodCallExpression).

(Hérité de Expression)
Compile()

Compile l'expression lambda décrite par l'arborescence de l'expression dans le code exécutable et produit un délégué qui représente l'expression lambda.Compiles the lambda expression described by the expression tree into executable code and produces a delegate that represents the lambda expression.

Compile(Boolean)

Compile l’expression lambda décrite par l’arborescence de l’expression dans du code interprété ou compilé, et produit un délégué qui représente l’expression lambda.Compiles the lambda expression described by the expression tree into interpreted or compiled code and produces a delegate that represents the lambda expression.

Compile(DebugInfoGenerator)

Produit un délégué qui représente l'expression lambda.Produces a delegate that represents the lambda expression.

CompileToMethod(MethodBuilder)

Compile le lambda dans une définition de méthode.Compiles the lambda into a method definition.

(Hérité de LambdaExpression)
CompileToMethod(MethodBuilder, DebugInfoGenerator)

Compile le lambda dans une définition de méthode, ainsi que des informations de débogage personnalisées.Compiles the lambda into a method definition and custom debug information.

(Hérité de LambdaExpression)
Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
Reduce()

Réduit le nœud en une expression plus simple.Reduces this node to a simpler expression. Si CanReduce retourne la valeur true, cela doit retourner une expression valide.If CanReduce returns true, this should return a valid expression. Cette méthode peut retourner un autre nœud qui doit lui-même être réduit.This method can return another node which itself must be reduced.

(Hérité de Expression)
ReduceAndCheck()

Réduit le nœud en une expression plus simple.Reduces this node to a simpler expression. Si CanReduce retourne la valeur true, cela doit retourner une expression valide.If CanReduce returns true, this should return a valid expression. Cette méthode peut retourner un autre nœud qui doit lui-même être réduit.This method can return another node which itself must be reduced.

(Hérité de Expression)
ReduceExtensions()

Réduit l'expression à un type de nœud connu (qui n'est pas un nœud Extension) ou retourne simplement l'expression s'il s'agit d'un type déjà connu.Reduces the expression to a known node type (that is not an Extension node) or just returns the expression if it is already a known type.

(Hérité de Expression)
ToString()

Retourne une représentation textuelle de Expression.Returns a textual representation of the Expression.

(Hérité de Expression)
Update(Expression, IEnumerable<ParameterExpression>)

Crée une expression semblable à celle-ci, mais utilisant les enfants fournis.Creates a new expression that is like this one, but using the supplied children. Si tous les enfants sont identiques, cette expression est retournée.If all of the children are the same, it will return this expression.

VisitChildren(ExpressionVisitor)

Réduit le nœud puis appelle le délégué visiteur sur l'expression réduite.Reduces the node and then calls the visitor delegate on the reduced expression. La méthode lève une exception si le nœud n'est pas réductible.The method throws an exception if the node is not reducible.

(Hérité de Expression)

S’applique à

Voir aussi