ExpressionBuilder Classe

Definição

public ref class ExpressionBuilder abstract

public abstract class ExpressionBuilder

type ExpressionBuilder = class

Public MustInherit Class ExpressionBuilder

Herança

Object

ExpressionBuilder

Derivado

System.Web.Compilation.AppSettingsExpressionBuilder

System.Web.Compilation.ConnectionStringsExpressionBuilder

System.Web.Compilation.ResourceExpressionBuilder

System.Web.Compilation.RouteUrlExpressionBuilder

System.Web.Compilation.RouteValueExpressionBuilder

Exemplos

Os exemplos de código a seguir demonstram como criar um construtor de expressões personalizado implementando a ExpressionBuilder classe abstrata. Essa implementação de ExpressionBuilder retorna uma instrução avaliada que é passada para a expressão. Para executar este exemplo, primeiro você deve registrar o construtor de expressões personalizadas no arquivo Web.config. O primeiro exemplo de código demonstra como registrar o construtor de expressões personalizadas no arquivo Web.config.

<configuration>  
    <system.web>  
       <compilation>  
          <expressionBuilders>  
              <add expressionPrefix="MyCustomExpression"  
               type="MyCustomExpressionBuilder"/>  
          </expressionBuilders>  
       </compilation>  
    </system.web>  
</configuration>  

O segundo exemplo de código demonstra como referenciar a expressão em um arquivo .aspx.

<asp:Label ID="Label1" runat="server"   
Text="<%$ MyCustomExpression:Hello, world! %>" />  

O terceiro exemplo de código demonstra como desenvolver um construtor de expressões personalizado derivando de ExpressionBuilder. Para executar este exemplo de código, você deve colocar a classe na pasta App_Code.

using System;
using System.CodeDom;
using System.Web.UI;
using System.ComponentModel;
using System.Web.Compilation;
using System.Web.UI.Design;

// Apply ExpressionEditorAttributes to allow the 
// expression to appear in the designer.
[ExpressionPrefix("MyCustomExpression")]
[ExpressionEditor("MyCustomExpressionEditor")]
public class MyExpressionBuilder : ExpressionBuilder
{
    // Create a method that will return the result 
    // set for the expression argument.
    public static object GetEvalData(string expression, Type target, string entry)
    {
        return expression;
    }

    public override object EvaluateExpression(object target, BoundPropertyEntry entry, 
    object parsedData, ExpressionBuilderContext context)
    {
        return GetEvalData(entry.Expression, target.GetType(), entry.Name);
    }

    public override CodeExpression GetCodeExpression(BoundPropertyEntry entry, 
    object parsedData, ExpressionBuilderContext context)
    {
        Type type1 = entry.DeclaringType;
        PropertyDescriptor descriptor1 = TypeDescriptor.GetProperties(type1)[entry.PropertyInfo.Name];
        CodeExpression[] expressionArray1 = new CodeExpression[3];
        expressionArray1[0] = new CodePrimitiveExpression(entry.Expression.Trim());
        expressionArray1[1] = new CodeTypeOfExpression(type1);
        expressionArray1[2] = new CodePrimitiveExpression(entry.Name);
        return new CodeCastExpression(descriptor1.PropertyType, new CodeMethodInvokeExpression(new 
       CodeTypeReferenceExpression(base.GetType()), "GetEvalData", expressionArray1));
    }

    public override bool SupportsEvaluate
    {
        get { return true; }
    }
}

Imports System.CodeDom
Imports System.Web.UI
Imports System.ComponentModel
Imports System.Web.Compilation
Imports System.Web.UI.Design

' Apply ExpressionEditorAttributes to allow the 
' expression to appear in the designer.
<ExpressionPrefix("MyCustomExpression")> _
<ExpressionEditor("MyCustomExpressionEditor")> _
Public Class MyExpressionBuilder
    Inherits ExpressionBuilder
    ' Create a method that will return the result 
    ' set for the expression argument.
    Public Shared Function GetEvalData(ByVal expression As String, _
       ByVal target As Type, ByVal entry As String) As Object
        Return expression
    End Function

    Public Overrides Function EvaluateExpression(ByVal target As Object, _
       ByVal entry As BoundPropertyEntry, ByVal parsedData As Object, _
       ByVal context As ExpressionBuilderContext) As Object
        Return GetEvalData(entry.Expression, target.GetType(), entry.Name)
    End Function

    Public Overrides Function GetCodeExpression(ByVal entry _
       As BoundPropertyEntry, ByVal parsedData As Object, ByVal context _
       As ExpressionBuilderContext) As CodeExpression
        Dim type1 As Type = entry.DeclaringType
        Dim descriptor1 As PropertyDescriptor = _
           TypeDescriptor.GetProperties(type1)(entry.PropertyInfo.Name)
        Dim expressionArray1(2) As CodeExpression
        expressionArray1(0) = New CodePrimitiveExpression(entry.Expression.Trim())
        expressionArray1(1) = New CodeTypeOfExpression(type1)
        expressionArray1(2) = New CodePrimitiveExpression(entry.Name)
        Return New CodeCastExpression(descriptor1.PropertyType, _
           New CodeMethodInvokeExpression(New CodeTypeReferenceExpression _
           (MyBase.GetType()), "GetEvalData", expressionArray1))
    End Function

    Public Overrides ReadOnly Property SupportsEvaluate() As Boolean
        Get
            Return True
        End Get
    End Property
End Class

Comentários

A ExpressionBuilder classe é a classe base para construtores de expressões, como a AppSettingsExpressionBuilder classe, que criam expressões de código durante a análise de página.

Os construtores de expressões analisam expressões declarativas e criam código para recuperar valores associados a uma propriedade de controle. Em cenários sem compilação, um construtor de expressões que dá suporte a um recurso sem compilação avalia a expressão durante o tempo de execução.

Quando o analisador de página encontra uma expressão delimitada com a cadeia <%$ %>de caracteres, ela cria um construtor de expressões para a expressão com base no prefixo na cadeia de caracteres. O prefixo é a parte da cadeia de caracteres à esquerda dos dois-pontos (:). Por exemplo, quando o analisador encontra a cadeia <%$ ConnectionStrings:MessageDB %>de caracteres, ele cria um ConnectionStringsExpressionBuilder objeto. Os prefixos estão associados a construtores de expressões no arquivo Web.config na ExpressionBuilders seção.

O lado direito da expressão declarativa é passado para o construtor de expressões para avaliação. Substitua o GetCodeExpression método para gerar código que será compilado com a página.

Se você quiser que o construtor de expressões personalizadas esteja ativo em páginas que não são compiladas, você também deve substituir o EvaluateExpression método para retornar um objeto que representa os resultados da expressão. Você também deve substituir a SupportsEvaluate propriedade para indicar que o construtor de expressões personalizadas dá suporte a páginas sem compilação.

Você pode definir um conjunto de propriedades e métodos para selecionar e avaliar uma expressão associada a uma propriedade de controle em tempo de design implementando um editor de expressões. O editor é marcado no construtor de expressões por meio de metadados de nível de classe. Para obter mais informações, consulte ExpressionEditor.

Notas aos Implementadores

Ao herdar da ExpressionBuilder classe, você deve substituir o GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext) método.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• ExpressionBuilderContext
• ExpressionBuilder
• ExpressionBuilderCollection
• AppSettingsExpressionBuilder
• ConnectionStringsExpressionBuilder