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.
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.
<expressionBuilders>
<add />
<clear/>
<remove />
</expressionBuilders>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
Keine.
Untergeordnete Elemente
Untertag |
Beschreibung |
|---|---|
add |
Optionales Element Fügt der Auflistung einen Verweis auf einen Ausdrucks-Generator hinzu. |
clear |
Optionales Element Entfernt alle Verweise auf geerbte Ausdrucks-Generatoren bis auf die vom aktuellen add-Element hinzugefügten Ausdrucks-Generatoren. |
remove |
Optionales Element Entfernt einen Verweis auf einen geerbten Ausdrucks-Generator aus der Auflistung. |
Ü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. |
Hinweise
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 Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physikalischer 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
Referenz
compilation-Element (ASP.NET-Einstellungsschema)
add-Element für expressionBuilders für compilation (ASP.NET-Einstellungsschema)
clear-Element für expressionBuilders für die Kompilierung (ASP.NET-Einstellungsschema)
remove-Element für expressionBuilders für die Kompilierung (ASP.NET-Einstellungsschema)
buildProviders-Element für die Kompilierung (ASP.NET-Einstellungsschema)
codeSubDirectories-Element für die Kompilierung (ASP.NET-Einstellungsschema)
compilers-Element für die Kompilierung (ASP.NET-Einstellungsschema)
assemblies-Element für die Kompilierung (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
Konzepte
Übersicht über die ASP.NET-Kompilierung
Übersicht über die Syntax von ASP.NET-Webseiten
ASP.NET-Konfigurationsdateihierarchie und Vererbung
Absichern der ASP.NET-Konfiguration
ASP.NET-Konfigurationsszenarios
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)