add-Element für expressionBuilders für compilation (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Fügt der Auflistung einen Verweis auf einen Ausdrucks-Generator hinzu.
Dieses Element ist neu in .NET Framework, Version 2.0.
<add
expressionPrefix = "prefix"
type = "type"
/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und ü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 Teil der Zeichenfolge, der sich links vom Doppelpunkt (:) befindet. 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 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
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Referenz
assemblies-Element für die Kompilierung (ASP.NET-Einstellungsschema)
remove-Element für expressionBuilders für die Kompilierung (ASP.NET-Einstellungsschema)
clear-Element für expressionBuilders für die Kompilierung (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
compilation-Element (ASP.NET-Einstellungsschema)
Konzepte
ASP.NET Configuration File Hierarchy
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen