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.
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, untergeordnete Elemente 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 |
Beschreibungen |
|---|---|
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 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
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
Ü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
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)