ExpressionBuilder Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Compilation

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Valuta le espressioni durante l'analisi della pagina.

public ref class ExpressionBuilder abstract

public abstract class ExpressionBuilder

type ExpressionBuilder = class

Public MustInherit Class ExpressionBuilder

Ereditarietà: Object
ExpressionBuilder

Derivato: System.Web.Compilation.AppSettingsExpressionBuilder

System.Web.Compilation.ConnectionStringsExpressionBuilder

System.Web.Compilation.ResourceExpressionBuilder

System.Web.Compilation.RouteUrlExpressionBuilder

System.Web.Compilation.RouteValueExpressionBuilder

Esempio

Gli esempi di codice seguenti illustrano come compilare un generatore di espressioni personalizzato implementando la ExpressionBuilder classe astratta. Questa implementazione di ExpressionBuilder restituisce un'istruzione valutata passata all'espressione. Per eseguire questo esempio, è prima necessario registrare il generatore di espressioni personalizzate nel file Web.config. Nel primo esempio di codice viene illustrato come registrare il generatore di espressioni personalizzate nel file Web.config.

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

Nel secondo esempio di codice viene illustrato come fare riferimento all'espressione in un file aspx.

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

Il terzo esempio di codice illustra come sviluppare un generatore di espressioni personalizzato derivando da ExpressionBuilder. Per eseguire questo esempio di codice, è necessario inserire la classe nella cartella 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

Commenti

La ExpressionBuilder classe è la classe base per i generatori di espressioni, ad esempio la AppSettingsExpressionBuilder classe , che creano espressioni di codice durante l'analisi della pagina.

I generatori di espressioni analizzano espressioni dichiarative e creano codice per recuperare i valori associati a una proprietà del controllo. Negli scenari senza compilazione, un generatore di espressioni che supporta una funzionalità senza compilazione valuta l'espressione durante l'esecuzione.

Quando il parser di pagina rileva un'espressione delimitata con la stringa <%$ %>, crea un generatore di espressioni per l'espressione in base al prefisso nella stringa. Il prefisso è la parte della stringa a sinistra dei due punti (:). Ad esempio, quando il parser rileva la stringa <%$ ConnectionStrings:MessageDB %>, crea un ConnectionStringsExpressionBuilder oggetto . I prefissi sono associati ai generatori di espressioni nel file Web.config nella ExpressionBuilders sezione .

Il lato destro dell'espressione dichiarativa viene passato al generatore di espressioni per la valutazione. Eseguire l'override del GetCodeExpression metodo per generare il codice che verrà compilato con la pagina.

Se si desidera che il generatore di espressioni personalizzate sia attivo in pagine non compilate, è necessario anche eseguire l'override del EvaluateExpression metodo per restituire un oggetto che rappresenta i risultati dell'espressione. È inoltre necessario eseguire l'override della SupportsEvaluate proprietà per indicare che il generatore di espressioni personalizzate supporta le pagine senza compilazione.

È possibile definire un set di proprietà e metodi per la selezione e la valutazione di un'espressione associata a una proprietà del controllo in fase di progettazione implementando un editor di espressioni. L'editor viene contrassegnato sul generatore di espressioni tramite metadati a livello di classe. Per altre informazioni, vedere ExpressionEditor.

Note per gli implementatori

Quando si eredita dalla ExpressionBuilder classe , è necessario eseguire l'override del GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext) metodo .

Costruttori

ExpressionBuilder()

Inizializza una nuova istanza della classe ExpressionBuilder.

Proprietà

SupportsEvaluate

Se sottoposto a override in una classe derivata, restituisce un valore che indica se l'oggetto ExpressionBuilder corrente supporta le pagine di non compilazione.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)	Quando viene eseguito l'override in una classe derivata, restituisce un oggetto che rappresenta un'espressione valutata.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)	Quando sottoposto a override in una classe derivata, restituisce il codice utilizzato durante l'esecuzione della pagina per ottenere l'espressione valutata.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ParseExpression(String, Type, ExpressionBuilderContext)	Quando sottoposto a override in una classe derivata, restituisce un oggetto che rappresenta l'espressione analizzata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a