Expression<TDelegate> Classe

Définition

Espace de noms:

System.Linq.Expressions

Assemblys:

netstandard.dll, System.Linq.Expressions.dll

Source:

LambdaExpression.cs

Représente une expression lambda fortement typée sous la forme d’une arborescence d’expressions. Cette classe ne peut pas être héritée.

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é que représente Expression<TDelegate> .

Héritage

Object

Expression

LambdaExpression

Expression<TDelegate>

Exemples

L’exemple de code suivant montre comment représenter une expression lambda 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 d’expressions. Il montre également comment réactiver l’arborescence d’expressions en code exécutable à l’aide de la Compile méthode.

// 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

Lorsqu’une expression lambda est affectée à une variable, un champ ou un paramètre dont le type est Expression<TDelegate>, le compilateur émet des instructions pour générer une arborescence d’expressions.

Note

Une conversion d’une expression lambda en type Expression<D> (Expression(Of D) en Visual Basic) existe si une conversion de l’expression lambda en délégué de type D existe. Toutefois, la conversion peut échouer, par exemple, si le corps de l’expression lambda est un bloc. Cela signifie que les délégués et les arborescences d’expressions se comportent de la même façon en ce qui concerne la résolution de surcharge.

L’arborescence d’expressions est une représentation de données en mémoire de l’expression lambda. L’arborescence d’expressions rend la structure de l’expression lambda transparente et explicite. Vous pouvez interagir avec les données de l’arborescence d’expressions comme vous le pouvez avec n’importe quelle autre structure de données.

La possibilité de traiter les 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. Par exemple, l’implémentation d’accès aux données LINQ to SQL utilise cette fonctionnalité pour traduire des arborescences d’expressions en instructions Transact-SQL qui peuvent être évaluées par la base de données.

De nombreux opérateurs de requête standard définis dans la Queryable classe ont un ou plusieurs paramètres de type Expression<TDelegate>.

L’un NodeTypeExpression<TDelegate> est Lambda.

Utilisez la ou Lambda<TDelegate>(Expression, ParameterExpression[]) la Lambda<TDelegate>(Expression, IEnumerable<ParameterExpression>) méthode pour créer un Expression<TDelegate> objet.

Propriétés

Nom	Description
Body	Obtient le corps de l’expression lambda. (Hérité de LambdaExpression)
CanReduce	Indique que le nœud peut être réduit à un nœud plus simple. Si cela retourne la valeur true, Reduce() peut être appelé pour produire le formulaire réduit. (Hérité de Expression)
Name	Obtient le nom de l’expression lambda. (Hérité de LambdaExpression)
NodeType	Retourne le type de nœud de ce Expression. (Hérité de LambdaExpression)
Parameters	Obtient les paramètres de l’expression lambda. (Hérité de LambdaExpression)
ReturnType	Obtient le type de retour de l’expression lambda. (Hérité de LambdaExpression)
TailCall	Obtient la valeur qui indique si l’expression lambda sera compilée avec l’optimisation des appels de fin. (Hérité de LambdaExpression)
Type	Obtient le type statique de l’expression que cela Expression représente. (Hérité de LambdaExpression)

Méthodes

Nom	Description
Accept(ExpressionVisitor)	Répartit vers la méthode de visite spécifique pour ce type de nœud. Par exemple, MethodCallExpression appelle le VisitMethodCall(MethodCallExpression). (Hérité de Expression)
Compile()	Compile l’expression lambda décrite par l’arborescence d’expressions en code exécutable et produit un délégué qui représente l’expression lambda.
Compile(Boolean)	Compile l’expression lambda décrite par l’arborescence d’expressions en code interprété ou compilé et produit un délégué qui représente l’expression lambda.
Compile(DebugInfoGenerator)	Produit un délégué qui représente l’expression lambda.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Reduce()	Réduit ce nœud à une expression plus simple. Si CanReduce retourne true, cela doit renvoyer une expression valide. Cette méthode peut retourner un autre nœud qui lui-même doit être réduit. (Hérité de Expression)
ReduceAndCheck()	Réduit ce nœud à une expression plus simple. Si CanReduce retourne true, cela doit renvoyer une expression valide. Cette méthode peut retourner un autre nœud qui lui-même doit être réduit. (Hérité de Expression)
ReduceExtensions()	Réduit l’expression à un type de nœud connu (qui n’est pas un nœud d’extension) ou retourne simplement l’expression s’il s’agit déjà d’un type connu. (Hérité de Expression)
ToString()	Retourne une représentation textuelle du Expression. (Hérité de Expression)
Update(Expression, IEnumerable<ParameterExpression>)	Crée une expression semblable à celle-ci, mais à l’aide des enfants fournis. Si tous les enfants sont identiques, il retourne cette expression.
VisitChildren(ExpressionVisitor)	Réduit le nœud, puis appelle le délégué visiteur sur l’expression réduite. La méthode lève une exception si le nœud n’est pas réductible. (Hérité de Expression)

Voir aussi

• Expressions lambda (Guide de programmation C#)