Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Fügt der Auflistung einen Verweis auf einen Ausdrucks-Generator hinzu.
Dieses Element ist neu in .NET Framework, Version 2.0.
<configuration>-Element
system.web-Element (ASP.NET-Einstellungsschema)
compilation-Element (ASP.NET-Einstellungsschema)
assemblies-Element für compilation (ASP.NET-Einstellungsschema)
add-Element für expressionBuilders für compilation (ASP.NET-Einstellungsschema)
<add
expressionPrefix = "prefix"
type = "type"
/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
expressionPrefix |
Erforderliches String-Attribut. Legt das Präfix für den Ausdruck fest. Diese Zeichenfolge ist der linke Teil eines Ausdrucks, wie er auf einer .aspx-Seite angezeigt wird, z. B.: <asp:Label ID="Label1" runat="server" Text="<%$ MyCustomExpression:Hello, world! %>" /> Dies ist der Auflistungsschlüssel. Der Standardwert ist eine leere Zeichenfolge (""). |
type |
Erforderliches String-Attribut. Gibt den Namen der Ausdrucks-Generatorklasse an, die für die Verarbeitung dieses Ausdrucks zuständig ist. Das kann eine benutzerdefinierte Klasse sein, die von der ExpressionBuilder-Klasse abgeleitet wurde. Der Standardwert ist eine leere Zeichenfolge (""). |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Gibt das Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
system.web |
Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an. |
compilation |
Konfiguriert alle Kompilierungseinstellungen, die ASP.NET zur Kompilierung von Anwendungen verwendet. |
expressionBuilders |
Definiert eine Auflistung von Ressourcenzeichenfolgen, die bei der Kompilierung zu verwenden ist. Die Ressourcenzeichenfolgen verknüpfen Präfixe mit Ausdrucks-Generatoren. Dieses Element ist neu in .NET Framework, Version 2.0. |
Hinweise
Das add-Element fügt der Auflistung einen Verweis auf einen Ausdrucks-Generator hinzu.
Das expressionBuilders-Element definiert eine bei der Kompilierung zu verwendende Ressourcenzeichenfolgenauflistung. Die Ressourcenzeichenfolgen verknüpfen Präfixe mit Ausdrucks-Generatoren.
Wenn der Seitenparser auf einer ASPX-Seite auf einen Ausdruck stößt, der durch die Zeichenfolge <%$ %> getrennt ist, erstellt der Parser für den Ausdruck einen auf dem Präfix in der Zeichenfolge basierenden Ausdrucks-Generator. Das Präfix ist der Abschnitt der Zeichenfolge links neben dem Doppelpunkt (:). Wenn der Parser beispielsweise auf die Zeichenfolge <%$ ConnectionStrings:MessageDB %> trifft, erstellt er ein ConnectionStringsExpressionBuilder-Objekt. Weitere Informationen finden Sie unter ExpressionBuilder.
Standardkonfiguration
Das folgende expressionBuilders-Standardelement wird nicht explizit in der Datei Machine.config oder der Stammdatei Web.config konfiguriert. Es ist jedoch die Standardkonfiguration, die von der Anwendung zurückgegeben wird. Zur expressionBuilders-Auflistung in der Web.config-Stammdatei werden Elemente hinzugefügt.
<expressionBuilders>
<clear />
</expressionBuilders>
Das folgende standardmäßige expressionBuilders-Element wird in der Web.config-Stammdatei konfiguriert.
<expressionBuilders>
<add expressionPrefix="Resources" type="System.Web.Compilation.ResourceExpressionBuilder" />
<add expressionPrefix="ConnectionStrings" type="System.Web.Compilation.ConnectionStringsExpressionBuilder" />
<add expressionPrefix="AppSettings" type="System.Web.Compilation.AppSettingsExpressionBuilder" />
</expressionBuilders>
Beispiel
Das folgende Codebeispiel zeigt, wie ein benutzerdefinierter Ausdrucks-Generator in der Datei Web.config registriert wird. Ein benutzerdefinierter Ausdrucks-Generator muss in der abstrakten ExpressionBuilder-Klasse implementiert werden.
Verwenden Sie folgende Syntax, um auf den Ausdruck in einer ASPX-Datei zu verweisen:
<asp:Label ID="Label1" runat="server"
Text="<%$ MyCustomExpression:Hello, world! %>" />
<configuration>
<system.web>
<compilation>
<expressionBuilders>
<add expressionPrefix="MyCustomExpression"
type="MyCustomExpressionBuilder"/>
</expressionBuilders>
</compilation>
</system.web>
</configuration>
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
Konfigurierbare Verzeichnisse |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer Verzeichnisse |
Anforderungen |
Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005 |
Siehe auch
Aufgaben
Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen
Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen
Konzepte
Übersicht über die ASP.NET-Kompilierung
Codemodell für ASP.NET-Webseiten
ASP.NET-Konfigurationsdateihierarchie und Vererbung
Absichern der ASP.NET-Konfiguration
ASP.NET-Konfigurationsszenarios
Referenz
assemblies-Element für compilation (ASP.NET-Einstellungsschema)
remove-Element für expressionBuilders für compilation (ASP.NET-Einstellungsschema)
clear-Element für expressionBuilders für compilation (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
compilation-Element (ASP.NET-Einstellungsschema)
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen