Expression<TDelegate> Classe

Definição

Representa uma expressão lambda fortemente tipada como uma estrutura de dados na forma de uma árvore de expressão.Represents a strongly typed lambda expression as a data structure in the form of an expression tree. Essa classe não pode ser herdada.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

Parâmetros de tipo

TDelegate

O tipo do delegado que o Expression<TDelegate> representa.The type of the delegate that the Expression<TDelegate> represents.

Herança
Expression<TDelegate>

Exemplos

O exemplo de código a seguir demonstra como representar uma expressão lambda como código executável na forma de um delegado e como dados na forma de uma árvore de expressão.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. Ele também demonstra como transformar a árvore de expressão de volta em código executável usando o Compile método.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

Comentários

Quando uma expressão lambda é atribuída a uma variável, campo ou parâmetro cujo tipo é Expression<TDelegate> , o compilador emite instruções para criar uma árvore de expressão.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.

Observação

Uma conversão de uma expressão lambda para tipo Expression<D> ( Expression(Of D) em Visual Basic) existe se houver uma conversão da expressão lambda em um delegado de tipo D .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. No entanto, a conversão pode falhar, por exemplo, se o corpo da expressão lambda for um bloco.However, the conversion may fail, for example, if the body of the lambda expression is a block. Isso significa que os delegados e as árvores de expressão se comportam da mesma forma com relação à resolução de sobrecarga.This means that delegates and expression trees behave similarly with regard to overload resolution.

A árvore de expressão é uma representação de dados na memória da expressão lambda.The expression tree is an in-memory data representation of the lambda expression. A árvore de expressão torna a estrutura da expressão lambda transparente e explícita.The expression tree makes the structure of the lambda expression transparent and explicit. Você pode interagir com os dados na árvore de expressão, assim como você pode com qualquer outra estrutura de dados.You can interact with the data in the expression tree just as you can with any other data structure.

A capacidade de tratar expressões como estruturas de dados permite que as APIs recebam o código do usuário em um formato que pode ser inspecionado, transformado e processado de maneira personalizada.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. Por exemplo, a implementação de acesso a dados do LINQ to SQL usa esse recurso para converter árvores de expressão em instruções Transact-SQL que podem ser avaliadas pelo banco de dados.For example, the LINQ to SQL data access implementation uses this facility to translate expression trees to Transact-SQL statements that can be evaluated by the database.

Muitos operadores de consulta padrão definidos na Queryable classe têm um ou mais parâmetros do tipo Expression<TDelegate> .Many standard query operators defined in the Queryable class have one or more parameters of type Expression<TDelegate>.

O NodeType de um Expression<TDelegate> é Lambda .The NodeType of an Expression<TDelegate> is Lambda.

Use o Lambda<TDelegate>(Expression, IEnumerable<ParameterExpression>) Lambda<TDelegate>(Expression, ParameterExpression[]) método ou para criar um Expression<TDelegate> objeto.Use the Lambda<TDelegate>(Expression, IEnumerable<ParameterExpression>) or Lambda<TDelegate>(Expression, ParameterExpression[]) method to create an Expression<TDelegate> object.

Propriedades

Body

Obtém o corpo da expressão lambda.Gets the body of the lambda expression.

(Herdado de LambdaExpression)
CanReduce

Indica que o nó pode ser reduzido a um nó mais simples.Indicates that the node can be reduced to a simpler node. Se isso retornar verdadeiro, Reduce() poderá ser chamado para produzir a forma reduzida.If this returns true, Reduce() can be called to produce the reduced form.

(Herdado de Expression)
Name

Obtém o nome da expressão lambda.Gets the name of the lambda expression.

(Herdado de LambdaExpression)
NodeType

Retorna o tipo de nó deste Expression.Returns the node type of this Expression.

(Herdado de LambdaExpression)
Parameters

Obtém os parâmetros da expressão lambda.Gets the parameters of the lambda expression.

(Herdado de LambdaExpression)
ReturnType

Obtém o tipo de retorno da expressão lambda.Gets the return type of the lambda expression.

(Herdado de LambdaExpression)
TailCall

Obtém o valor que indica se a expressão lambda será compilada com a otimização de chamada tail.Gets the value that indicates if the lambda expression will be compiled with the tail call optimization.

(Herdado de LambdaExpression)
Type

Obtém o tipo estático da expressão que esse Expression representa.Gets the static type of the expression that this Expression represents.

(Herdado de LambdaExpression)

Métodos

Accept(ExpressionVisitor)

Expede o método específico de visita para esse tipo de nó.Dispatches to the specific visit method for this node type. Por exemplo, MethodCallExpression chama o VisitMethodCall(MethodCallExpression).For example, MethodCallExpression calls the VisitMethodCall(MethodCallExpression).

(Herdado de Expression)
Compile()

Compila a expressão lambda descrita pela árvore de expressão em um código executável e produz um delegado que representa a expressão lambda.Compiles the lambda expression described by the expression tree into executable code and produces a delegate that represents the lambda expression.

Compile(Boolean)

Compila a expressão lambda descrita pela árvore de expressão em um código interpretado ou compilado e produz um delegado que representa a expressão 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(Boolean)

Produz um delegado interpretado ou compilado que representa a expressão lambda.Produces an interpreted or compiled delegate that represents the lambda expression.

(Herdado de LambdaExpression)
Compile(DebugInfoGenerator)

Produz um delegado que representa a expressão lambda.Produces a delegate that represents the lambda expression.

Compile(DebugInfoGenerator)

Produz um delegado que representa a expressão lambda.Produces a delegate that represents the lambda expression.

(Herdado de LambdaExpression)
CompileToMethod(MethodBuilder)

Compila o lambda em uma definição de método.Compiles the lambda into a method definition.

(Herdado de LambdaExpression)
CompileToMethod(MethodBuilder, DebugInfoGenerator)

Compila o lambda em uma definição de método e as informações de depuração personalizada.Compiles the lambda into a method definition and custom debug information.

(Herdado de LambdaExpression)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Reduce()

Reduz esse nó a uma expressão mais simples.Reduces this node to a simpler expression. Se CanReduce retornar true, ele deverá retornar uma expressão válida.If CanReduce returns true, this should return a valid expression. Esse método pode retornar outro nó que também precisa ser reduzido.This method can return another node which itself must be reduced.

(Herdado de Expression)
ReduceAndCheck()

Reduz esse nó a uma expressão mais simples.Reduces this node to a simpler expression. Se CanReduce retornar true, ele deverá retornar uma expressão válida.If CanReduce returns true, this should return a valid expression. Esse método pode retornar outro nó que também precisa ser reduzido.This method can return another node which itself must be reduced.

(Herdado de Expression)
ReduceExtensions()

Reduz a expressão a um tipo de nó conhecido (que não é um nó de extensão) ou apenas retorna a expressão se ele já é um tipo conhecido.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.

(Herdado de Expression)
ToString()

Retorna uma representação textual de Expression.Returns a textual representation of the Expression.

(Herdado de Expression)
Update(Expression, IEnumerable<ParameterExpression>)

Cria uma nova expressão que é parecida com esta, mas usando os filhos fornecidos.Creates a new expression that is like this one, but using the supplied children. Se todos os filhos forem os mesmos, ela retornará esta expressão.If all of the children are the same, it will return this expression.

VisitChildren(ExpressionVisitor)

Reduz o nó e, em seguida, chama o delegado visitante na expressão reduzida.Reduces the node and then calls the visitor delegate on the reduced expression. O método gera uma exceção se o nó não é reduzível.The method throws an exception if the node is not reducible.

(Herdado de Expression)

Aplica-se a