ExpressionBuilder Класс

Ссылка

Определение

Пространство имен:: System.Web.Compilation

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Вычисляет выражение во время анализа страницы.

public ref class ExpressionBuilder abstract

public abstract class ExpressionBuilder

type ExpressionBuilder = class

Public MustInherit Class ExpressionBuilder

Наследование: Object
ExpressionBuilder

Производный: System.Web.Compilation.AppSettingsExpressionBuilder

System.Web.Compilation.ConnectionStringsExpressionBuilder

System.Web.Compilation.ResourceExpressionBuilder

System.Web.Compilation.RouteUrlExpressionBuilder

System.Web.Compilation.RouteValueExpressionBuilder

Примеры

В следующих примерах кода показано, как создать построитель пользовательских выражений путем реализации абстрактного ExpressionBuilder класса. Эта реализация ExpressionBuilder возвращает вычислимую инструкцию, передаваемую в выражение. Чтобы запустить этот пример, сначала необходимо зарегистрировать построитель пользовательских выражений в файле Web.config. В первом примере кода показано, как зарегистрировать построитель пользовательских выражений в файле Web.config.

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

Во втором примере кода показано, как ссылаться на выражение в ASPX-файле.

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

В третьем примере кода показано, как разработать настраиваемый построитель выражений путем наследования от ExpressionBuilder. Чтобы выполнить этот пример кода, необходимо поместить класс в папку 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

Класс ExpressionBuilder является базовым классом для построителей выражений, таких как AppSettingsExpressionBuilder класс, который создает выражения кода во время синтаксического анализа страниц.

Построитель выражений анализирует декларативные выражения и создает код для получения значений, привязанных к свойству элемента управления. В сценариях без компиляции построитель выражений, поддерживающий функцию без компиляции, оценивает выражение во время выполнения.

Когда средство синтаксического анализа страницы обнаруживает выражение, разделенное строкой <%$ %>, оно создает построитель выражений для выражения на основе префикса в строке. Префикс — это часть строки, которая находится слева от двоеточия (:). Например, когда средство синтаксического анализа обнаруживает строку <%$ ConnectionStrings:MessageDB %>, он создает ConnectionStringsExpressionBuilder объект. Префиксы связаны с построителями выражений в файле Web.config в ExpressionBuilders разделе.

Правая сторона декларативного выражения передается построителю выражений для оценки. Переопределите GetCodeExpression метод для создания кода, который будет скомпилирован с помощью страницы.

Если вы хотите, чтобы пользовательский построитель выражений был активным на страницах, которые не компилируются, необходимо также переопределить EvaluateExpression метод для возврата объекта, представляющего результаты выражения. Кроме того, необходимо переопределить SupportsEvaluate свойство, указывающее, что построитель пользовательских выражений поддерживает страницы без компиляции.

Можно определить набор свойств и методов для выбора и оценки выражения, связанного со свойством элемента управления во время разработки, путем реализации редактора выражений. Редактор помечается в построителе выражений с помощью метаданных уровня класса. Для получения дополнительной информации см. ExpressionEditor.

Примечания для тех, кто реализует этот метод

При наследовании от ExpressionBuilder класса необходимо переопределить GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext) метод.

Конструкторы

ExpressionBuilder()

Инициализирует новый экземпляр класса ExpressionBuilder.

Свойства

SupportsEvaluate

При переопределении в производном классе возвращает значение, позволяющее определить, поддерживает ли текущий объект ExpressionBuilder некомпилируемые страницы.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)	При переопределении в производном классе возвращает объект, представляющий вычисленное выражение.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)	При переопределении в производном классе возвращает код, используемый во время выполнения страницы для получения вычисленного выражения.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ParseExpression(String, Type, ExpressionBuilderContext)	При переопределении в производном классе возвращает объект, представляющий проанализированное выражение.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Применяется к