pages-Element (ASP.NET-Einstellungsschema)
Aktualisiert: November 2007
Definiert global seitenspezifische Konfigurationseinstellungen, z. B. ASP.NET-Direktiven für Seiten und Steuerelemente innerhalb des Gültigkeitsbereichs der Konfigurationsdatei.
configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
pages-Element (ASP.NET-Einstellungsschema)
<pages
buffer="[True|False]"
enableEventValidation="[True|False]"
enableSessionState="[True|False|ReadOnly]"
enableViewState="[True|False]"
enableViewStateMac="[True|False]"
smartNavigation="[True|False]"
autoEventWireup="[True|False]"
pageBaseType="typename, assembly"
userControlBaseType="typename"
validateRequest="[True|False]"
masterPageFile="file path"
theme="string"
styleSheetTheme="string"
maxPageStateFieldLength="number"
compilationMode="[Always|Auto|Never]"
pageParserFilterType="string"
viewStateEncryptionMode="[Always|Auto|Never]"
maintainScrollPositionOnPostBack="[True|False]"
asyncTimeout="number"
>
<controls>...</controls>
<namespaces>...</namespaces>
<tagMapping>...</tagMapping>
</pages>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
||||||||
|---|---|---|---|---|---|---|---|---|---|
asyncTimeout |
Optionales TimeSpan-Attribut. Legt fest, wie viele Sekunden bei einer asynchronen Verarbeitung auf die Beendigung eines asynchronen Handlers gewartet wird. Dieses Attribut ist neu in .NET Framework, Version 2.0. Der Standardwert beträgt "0:00:45" (45 Sekunden). |
||||||||
autoEventWireup |
Optionales Boolean-Attribut. Legt fest, ob Seitenereignisse automatisch aktiviert werden. Dies ist der Fall, wenn die automatische Ereignisverknüpfung aktiviert ist und die Methoden einer bestimmten Signatur (z. B. page_Load ) automatisch angefügt werden. Weitere Informationen hierzu finden Sie unter Ereignismodell für ASP.NET-Webserversteuerelemente. Die Standardeinstellung ist True. |
||||||||
buffer |
Optionales Boolean-Attribut. Gibt an, ob die URL-Ressource die Antwortpufferung verwendet. Die Standardeinstellung ist True. |
||||||||
compilationMode |
Optionales CompilationMode-Attribut. Legt fest, ob eine ASP.NET-Seite oder ein ASP.NET-Steuerelement zur Laufzeit kompiliert werden soll. Das compilationMode-Attribut ist neu in .NET Framework 2.0. Dieses Attribut kann einen der folgenden möglichen Werte annehmen. Die Standardeinstellung ist Always.
|
||||||||
enableEventValidation |
Gibt an, ob Seiten und Steuerelemente Postback- und Rückrufereignisse überprüfen. Der Standardwert ist True. |
||||||||
enableSessionState |
Optionales String-Attribut. Legt Anforderungen für den Sitzungszustand der Ressourcen fest, die innerhalb des Gültigkeitsbereichs der Konfigurationsdatei liegen. Das enableSessionState-Attribut kann einen der folgenden möglichen Werte annehmen. Die Standardeinstellung ist True.
|
||||||||
enableViewState |
Optionales Boolean-Attribut. Legt fest, ob der Ansichtszustand über Seitenanforderungen hinweg erhalten bleibt. Die Standardeinstellung ist True. |
||||||||
enableViewStateMac |
Optionales Boolean-Attribut. Gibt an, ob ASP.NET einen Nachrichtenauthentifizierungscode (Message Authentication Code, MAC) für den Ansichtszustand der Seite durchführen soll, wenn die Seite vom Client zurückgesendet wird. Falls True, wird der verschlüsselte Ansichtszustand überprüft, um sicherzustellen, dass er nicht auf dem Client manipuliert wurde. Die Standardeinstellung ist True. |
||||||||
maintainScrollPositionOnPostBack |
Optionales Boolean-Attribut. Legt fest, ob der Benutzer auf die gleiche Position im Clientbrowser gesetzt wird, wenn Seiten an den Server zurückgesandt werden. Wenn der Wert False ist, wird der Benutzer bei einem Postback in den oberen Bereich der Seite zurückgesetzt. Dieses Attribut ist neu in .NET Framework 2.0. Die Standardeinstellung ist False. |
||||||||
masterPageFile |
Optionales String-Attribut. Legt den Masterseitenpfad relativ zur lokalen Konfigurationsdatei fest. Seiten, deren masterPageFile-Attribut auf True festgelegt ist, müssen ein Content-Steuerelement als Steuerelement der obersten Ebene enthalten. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert ist eine leere Zeichenfolge (""). |
||||||||
maxPageStateFieldLength |
Optionales Int32-Attribut. Gibt die maximale Länge in Zeichen für das Zustandsfeld der Seite an. Wenn Sie eine positive Zahl angeben, wird das Ansichtszustandsfeld, das an den Clientbrowser gesendet wird, in einzelne Segmente aufgeteilt, die alle kleiner sind als die im maxPageStateFieldLength-Attribut angegebene Größe. Bei einer negativen Zahl darf das Ansichtszustandsfeld nicht in Segmente aufgeteilt werden. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert ist "-1". |
||||||||
pageBaseType |
Optionales String-Attribut. Gibt die zu verwendende Basis bei ausschließlich eigenständigen Seiten an. Es wird vom inherits-Attribut einer eigenständigen Datei überschrieben. Die Standardeinstellung ist "System.Web.UI.Page". |
||||||||
pageParserFilterType |
Optionales String-Attribut. Legt den Typnamen eines Filters fest, der vom ASP.NET-Parser für die Zulassung von Elementen während der Analysezeit verwendet wird. Der Filter muss aus der PageParserFilter-Klasse abgeleitet sein. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert ist eine leere Zeichenfolge (""). |
||||||||
smartNavigation |
Optionales Boolean-Attribut. Gibt an, ob die intelligente Navigation aktiviert ist. Für die intelligente Navigation benötigen Sie Microsoft Internet Explorer ab Version 5.5. Der Benutzer hat bei aktivierter intelligenter Navigation folgende Vorteile:
Dieses Attribut ist neu in .NET Framework 2.0, doch wird an seiner Stelle das maintainScrollPositionOnPostBack-Attribut verwendet. Die Standardeinstellung ist False. |
||||||||
styleSheetTheme |
Optionales String-Attribut. Gibt den Namen des Ordners "named theme" an, der für die Anwendung des Designs vor der Deklaration von Steuerelementen verwendet wird. Im Gegensatz dazu wird in der Definition des theme-Attributs festgelegt, dass das Design nach der Deklaration der Steuerelemente angewendet wird. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert ist eine leere Zeichenfolge (""). |
||||||||
theme |
Optionales String-Attribut. Legt den Namen des Designs für die Seiten fest, die sich innerhalb des Gültigkeitsbereichs der Konfigurationsdatei befinden. Das festgelegte Design muss entweder als Anwendung oder globales Design vorliegen. Wenn das Design nicht vorhanden ist, wird eine HttpException-Ausnahme ausgelöst. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert ist eine leere Zeichenfolge (""). |
||||||||
userControlBaseType |
Optionales String-Attribut. Gibt die zu verwendende Basis bei ausschließlich eigenständigen Seiten an. Der Standardwert ist "System.Web.UI.UserControl". |
||||||||
validateRequest |
Optionales Boolean-Attribut. Gibt an, dass ASP.NET alle vom Browser eingehende Daten auf potenziell gefährliche Daten untersucht. Wenn True, erfolgt die Anforderungsvalidierung durch einen Vergleich aller Eingangsdaten mit einer Liste von potenziell gefährlichen Werten. Wenn eine Übereinstimmung gefunden wird, löst ASP.NET eine HttpRequestValidationException-Ausnahme aus. Die Standardeinstellung ist True. |
||||||||
viewStateEncryptionMode |
Optionales ViewStateEncryptionMode-Attribut. Legt den Verschlüsselungsmodus des Ansichtszustands fest. Die ViewStateEncryptionMode-Eigenschaft überschreibt dieses Attribut, das in der Konfigurationsdatei festgelegt wird. Dieses Attribut kann einen der folgenden möglichen Werte annehmen.
Dieses Attribut ist neu in .NET Framework 2.0. Die Standardeinstellung ist Auto. |
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
controls |
Definiert eine Auflistung von Register-Direktiven und Namespaces, in denen sich Tagpräfixe befinden. |
namespaces |
Definiert eine Auflistung der während der Assemblyvorkompilierung zu verwendenden Import-Direktiven. |
tagMapping |
Definiert eine Auflistung von Tagtypen, die anderen Tagtypen zur Kompilierungszeit neu zugeordnet wurden. |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Das erforderliche Stammelement in jeder Konfigurationsdatei, die von der Common Language Runtime und den .NET Framework-basierten Anwendungen verwendet wird. |
system.web |
Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an und enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern. |
Hinweise
Das pages-Element definiert seitenspezifische Konfigurationseinstellungen. Dieser Konfigurationsabschnitt unterstützt die Festlegung bestimmter Direktiven für ASP.NET-Seiten und Steuerelemente global für alle Seiten und Steuerelemente im Bereich der Konfigurationsdatei. Dies schließt folgende Direktiven auf Seitenebene ein, die Einstellungen festlegen, die von der Seite und von benutzergesteuerten Compilern bei der Verarbeitung von ASP.NET Web Forms-Seiten (.aspx) und Benutzersteuerelementdateien (.ascx) durch Compiler verwendet werden.
Die @ Page-Direktive (@ Page).
Die @ Import-Direktive (@ Import), über das untergeordnete namespaces-Element.
Die @ Register-Direktive (@ Register), über das untergeordnete controls-Element.
Das pages-Element bietet über das tagMapping-Element auch Unterstützung für die Zuordnung unterschiedlicher Tagtypen zur Laufzeit.
Tipp
Beim Hinzufügen einer @ Page-Direktive zu einer Masterseite ist es nicht zulässig, dieselbe Direktivendeklaration in Seiten zu verwenden, die von der Masterseite abhängig sind. Verwenden Sie stattdessen das pages-Konfigurationselement, um Seitendirektiven global zu definieren.
Standardkonfiguration
Das folgende pages-Standardelement wird nicht explizit in der Datei Machine.config oder der Stammdatei Web.config konfiguriert. Es handelt sich jedoch um die Standardkonfiguration, die von einer Anwendung zurückgegeben wird. Namespaces und Steuerelemente werden im Web.config-Stammverzeichnis hinzugefügt.
<pages
buffer="true"
enableSessionState="true"
enableViewState="true"
enableViewStateMac="true"
smartNavigation="false"
autoEventWireup="true"
pageBaseType="System.Web.UI.Page"
userControlBaseType="System.Web.UI.UserControl"
validateRequest="true"
masterPageFile=""
theme=""
styleSheetTheme=""
maxPageStateFieldLength="-1"
compilationMode="Always"
pageParserFilterType=""
viewStateEncryptionMode="Auto"
maintainScrollPositionOnPostBack="false"
asyncTimeout="45"
>
<namespaces>
<clear />
</namespaces>
<tagMapping>
<clear />
</tagMapping>
</pages>
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mehrere Seitenkonfigurationseinstellungen angeben.
<configuration>
<system.web>
<pages buffer="true"
enableSessionState="true"
autoEventWireup="true"
maintainScrollPositionOnPostBack="true"
masterPageFile = "~/Masters/Page1.master" />
</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 1.0, 1.1 oder 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
ASP.NET-Konfigurationsdateihierarchie und Vererbung
Absichern der ASP.NET-Konfiguration
Referenz
configuration-Element (allgemeines Einstellungsschema)
controls-Element für pages (ASP.NET-Einstellungsschema)
namespaces-Element für pages (ASP.NET-Einstellungsschema)
tagMapping-Element für pages (ASP.NET-Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen