PagesSection-Klasse

Stellt den Abschnitt <pages> einer Web.config-Datei dar.

Syntax

class PagesSection : ConfigurationSectionWithCollection  

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der PagesSection-Klasse verfügbar gemacht werden.

Name	Beschreibung
Add (Hinzufügen)	(Geerbt von ConfigurationSectionWithCollection.)
Clear	(Geerbt von ConfigurationSectionWithCollection.)
Get	(Geerbt von ConfigurationSectionWithCollection.)
GetAllowDefinition	(Geerbt von ConfigurationSection.)
GetAllowLocation	(Geerbt von ConfigurationSection.)
Remove	(Geerbt von ConfigurationSectionWithCollection.)
RevertToParent	(Geerbt von ConfigurationSection.)
SetAllowDefinition	(Geerbt von ConfigurationSection.)
SetAllowLocation	(Geerbt von ConfigurationSection.)

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der PagesSection-Klasse verfügbar gemacht werden.

Name	Beschreibung
AsyncTimeout	Einen Lese-/Schreibwert datetime, der die Zeit angibt, die die Seite wartet, um asynchrone Aufgaben auszuführen. Der Standardwert beträgt 45 Sekunden.
AutoEventWireup	Ein Lese-/Schreibwert boolean. true wenn Ereignisse für ASP.NET Seiten automatisch mit Ereignisbehandlungsfunktionen verbunden sind; andernfalls false. Der Standardwert ist true. Hinweis: Wenn diese Eigenschaft true ist, erfordert ASP.NET keine Ereignisse zum Angeben von Ereignishandlern wie z. B. Page_Load oder Page_Init. Das bedeutet, dass das Schlagwort Handles in Visual Basic im Serverskript auf der Web Forms-Seite nicht erforderlich ist. Wenn die ASP.NET-Webanwendung in Visual Studio erstellt wird, wird der Wert der AutoEventWireup Eigenschaft standardmäßig auf false in der .aspx-Seite oder beim .ascx-Steuerelement festgelegt, und Ereignishandler werden nicht automatisch erstellt. Legen Sie AutoEventWireup nicht als true fest, wenn die Leistung ein wichtiger Faktor ist.
Buffer	Ein Lese-/Schreibwert boolean. true, wenn .aspx-Seiten und -Steuerelemente Antwortpuffer verwenden; andernfalls false. Der Standardwert ist true. Hinweis: Wenn die Antwortpufferung aktiviert ist, wird die Seiten- oder Steuerelementausgabe gepuffert, bis die gesamte Seite oder das gesamte Steuerelement verarbeitet wurde. Legen Sie diese Eigenschaft nicht als true fest, wenn die Leistung ein wichtiger Faktor ist.
CompilationMode	Eine Lese-/Schreibenumeration sint32, die angibt, ob .aspx-Seiten und -Steuerelemente zur Laufzeit kompiliert werden. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
Controls	Ein TagPrefixInfo-Wert, der Konfigurationsinformationen für benutzerdefinierte und Benutzersteuerelemente enthält.
EnableEventValidation	Ein boolean-Wert. true wenn die Ereignisüberprüfung durchgeführt werden soll; andernfalls false. Der Standardwert ist true. Der Ereignisüberprüfungsmechanismus beseitigt das Risiko nicht autorisierter Postbackanforderungen und Rückrufe aus einem Steuerelement. Während des Renderns registriert ein Steuerelement seine Ereignisse und überprüft dann nur die spezifischen Ereignisse, die während einer Postbackanforderung oder eines Rückrufs für das Steuerelement ausgelöst werden können. Alle ereignisgesteuerten Steuerelemente in ASP.NET verwenden jetzt standardmäßig dieses Feature. Sie können jedoch das Verhalten von .NET Framework Version 1.0 wiederherstellen, indem Sie die Ereignisüberprüfung für eine Webanwendung optional deaktivieren. Hinweis: Das Basissteuerelement prüft diese Eigenschaft, um zu bestimmen, ob Ereignisse überprüft werden sollen. Ein abgeleitetes Steuerelement erbt diese Basissteuerelementeinstellung nicht, daher ist es standardmäßig von der Ereignisüberprüfung ausgenommen. Sie können ASP.NET dennoch anweisen, die Ereignisüberprüfung für das abgeleitete Steuerelement durchzuführen, indem Sie die Eigenschaft EnableEventValidation zum abgeleiteten Steuerelement selbst hinzufügen und auf true festlegen.
EnableSessionState	Ein Lese-/Schreibwert sint32, der angibt, ob der Sitzungszustand aktiviert ist. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
EnableViewState	Ein Lese-/Schreibwert boolean. true wenn der Ansichtszustand aktiviert ist; andernfalls false. lautet die Standardeinstellung true.
EnableViewStateMac	Ein Lese-/Schreibwert boolean. true, wenn ASP.NET eine Nachrichtenauthentifizierungsprüfung im Ansichtszustand der Seite ausführen soll, wenn die Seite vom Client zurück gepostet wird; andernfalls false. Der Standardwert ist true. Hinweis: Aus Sicherheitsgründen sollte diese Eigenschaft immer auf „true“ festgelegt werden.
Location	(Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
MaintainScrollPositionOnPostBack	Ein Lese-/Schreibwert boolean. true wenn die Position auf der Browserseite nach dem Postback beibehalten werden sollte; andernfalls false. Der Standardwert ist false.
MasterPageFile	Ein Lese-/Schreibwert string, der einen Verweis auf die Musterseite für die Anwendung angibt. Die Zeichenfolge kann entweder einen relativen oder einen absoluten Pfad enthalten.
MaxPageStateFieldLength	Ein Lese-/Schreibwert sint32, der die maximale Anzahl von Zeichen angibt, die ein einzelnes Ansichtszustandsfeld enthalten kann. Der Standardwert ist –1 (kein Grenzwert angegeben). Wenn die Länge der gespeicherten Daten den angegebenen Wert überschreitet, werden die Daten zwischen mehreren Ansichtszustandsfeldern aufgeteilt.
Namespaces	Ein NamespaceInfo-Wert, der Namespaceverweise enthält, die automatisch auf alle Seiten einer Webanwendung importiert werden. Dadurch werden die Klassen der angegebenen Namespaces für die Verwendung auf der Seite verfügbar.
PageBaseType	Ein Lese-/Schreibwert string, der eine CodeBehind-Klasse angibt, welche .aspx-Seiten standardmäßig erben. Der Standardwert ist „System.Web.UI.Page“.
PageParserFilterType	Ein Lese-/Schreibwert string, der den Parserfiltertyp angibt. Ein Parserfilter ist eine Instanz der Klasse System.Web.UI.PageParserFilter. Zur Laufzeit ruft der Seitenkompilierungsprozess den Parserfilter auf, um vor der Analyse der Seite nach Änderungen am Quellcode zu suchen.
Path	(Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
SectionInformation	(Geerbt von ConfigurationSection.)
SmartNavigation	Ein Lese-/Schreibwert boolean. true, wenn die intelligente Navigation aktiviert ist; andernfalls false. Der Standardwert ist false. Hinweis: Für die intelligente Navigation ist Microsoft Internet Explorer 5.5, 6 oder 7 erforderlich.
StyleSheetTheme	Ein Wert mit Lese-/Schreibzugriff string, der den Namen eines ASP.NET Stylesheetdesigns angibt.
TagMapping	Ein TagMapInfo-Wert, der Konfigurationstag-Neuzuordnungsanweisungen enthält. Mit dieser Eigenschaft können Sie die Typen von Tags während der Kompilierung neu zuordnen. Die Neuzuordnung bewirkt, dass der zugeordnete Typ anstelle des ursprünglichen Tagtyps für alle Seiten und Steuerelemente in der ASP.NET Anwendung im Bereich der Konfigurationsdatei verwendet wird.
Theme	Ein Wert mit Lese-/Schreibzugriff string, der den Namen eines ASP.NET Pagedesigns angibt.
UserControlBaseType	Ein Lese-/Schreibwert string, der eine CodeBehind-Klasse angibt, welche Benutzersteuerelemente standardmäßig erben. Der Standardwert ist „System.Web.UI.UserControl“.
ValidateRequest	Ein Lese-/Schreibwert boolean. true wenn ASP.NET Anforderungsüberprüfung für alle Eingaben aus dem Browser durchführt; andernfalls false. Der Standardwert ist true. Die Anforderungsüberprüfung wird durchgeführt, indem Eingabedaten mit einer Liste potenziell gefährlicher Werte verglichen werden. Wenn eine Übereinstimmung auftritt, löst ASP.NET eine System.Web.HttpRequestValidationException aus.
ViewStateEncryptionMode	Eine Lese-/Schreibaufzählung sint32, die den Verschlüsselungsmodus angibt, den ASP.NET für Ansichtszustandswerte verwendet. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die CompilationMode Eigenschaft angezeigt. Der Standardwert ist 2 (Always).

Wert	Schlüsselwort	Beschreibung
0	Auto	ASP.NET kompiliert die Seite nicht, sofern möglich.
1	Never	Die Seite oder das Steuerelement wird nie dynamisch kompiliert. Diese Einstellung erhöht die Leistung, indem die angegebene Seite vom Kompilierungsprozess ausgeschlossen wird. Wenn eine Seite einen Skriptblock oder ein Codekonstrukt enthält, das Kompilierung erfordert, gibt ASP.NET einen Fehler zurück und die Seite wird nicht ausgeführt.
2	Always	Die Seite sollte immer kompiliert werden.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die EnableSessionState Eigenschaft angezeigt. Der Standardwert ist 2 (True).

Wert	Schlüsselwort	Beschreibung
0	False	Der Sitzungszustand ist deaktiviert.
1	ReadOnly	Der Sitzungszustand ist schreibgeschützt.
2	True	Der Sitzungsstatus ist aktiviert.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die ViewStateEncryptionMode Eigenschaft angezeigt. Der Standardwert ist 0 (Auto).

Wert	Schlüsselwort	Beschreibung
0	Auto	Die Ansichtsstatusinformationen werden verschlüsselt, wenn ein Steuerelement Verschlüsselung durch Aufrufen der System.Web.UI.Page.RegisterRequiresViewStateEncryption-Methode anfordert.
1	Always	Die Ansichtsstatusinformationen werden immer verschlüsselt.
2	Never	Die Ansichtsstatusinformationen werden niemals verschlüsselt, auch wenn ein Steuerelement das anfordert.

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

PagesSection

Anforderungen

type	Beschreibung
Client	- IIS 7.0 unter Windows Vista - IIS 7.5 unter Windows 7 - IIS 8.0 unter Windows 8 - IIS 10.0 unter Windows 10
Server	- IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 - IIS 8.0 auf Windows Server 2012 - IIS 8.5 unter Windows Server 2012 R2 - IIS 10.0 auf Windows Server 2016
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

Microsoft.Web.Management.Client.Win32.ModulePage.Microsoft.Web.Management.Client.IModulePage.Initialize
System.Web.UI.Page.RegisterRequiresViewStateEncryption
System.Web.Configuration.PagesSectionSystem.Web.HttpRequestValidationException
AspSession-Klasse
ConfigurationSectionWithCollection-Klasse
NamespaceInfo-Klasse
SessionPageStateSection-Klasse
SessionStateSection-Klasse
TagMapElement-Klasse
TagMapInfo-Klasse
TagPrefixElement-Klasse
TagPrefixInfo-Klasse
CompilationMode Enumeration