CustomErrorsSection-Klasse

Artikel
04/01/2024

Konfiguriert benutzerdefinierte ASP.NET-Fehlermeldungen.

Syntax

class CustomErrorsSection : ConfigurationSectionWithCollection

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der CustomErrorsSection-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 CustomErrorsSection-Klasse verfügbar gemacht werden.

Name	Beschreibung
`CustomErrors`	Ein Array von CustomError-Werten, die ASP.NET benutzerdefinierten Fehler angeben.
`DefaultRedirect`	Ein erforderlicher Wert mit nicht benötigtem Lese-/Schreibzugriff `string`, der den Standardpfad einer HTTP-Fehlermeldungsdatei oder die URL einer Fehlermeldung enthält. Dieser Wert wird von der `Redirect` Eigenschaft neu erstellter CustomError-Objekte geerbt.
`Location`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`Mode`	Eine Lese-/Schreibaufzählung `sint32`, die angibt, ob benutzerdefinierte oder Standardfehlerseiten lokal oder remote angezeigt werden. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`Path`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`SectionInformation`	(Geerbt von `ConfigurationSection`.)

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Die von der CustomErrorsSection-Klasse dargestellten benutzerdefinierten Fehler sind spezifisch für ASP.NET und befinden sich im <system.web>-Abschnitt der Web.config-Datei. Jeder dieser Fehler wird durch eine Instanz der CustomError-Klasse dargestellt.

Die benutzerdefinierten Fehler, die durch die HttpErrorsSection-Klasse dargestellt werden, beziehen sich auf IIS 7 und befinden sich im <system.webServer>-Abschnitt der ApplicationHost.config-Datei. Jeder dieser Fehler wird durch eine Instanz der HttpErrorElement-Klasse dargestellt. Die Integration von ASP.NET mit IIS in IIS 7 hat diese Namensänderung erforderlich gemacht.

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

Wert	Schlüsselwort	Beschreibung
0	`RemoteOnly`	Die Standardmäßige ASP.NET Fehlerseite wird lokalen Benutzern angezeigt. Remotebenutzer erhalten eine benutzerdefinierte Fehlerseite, wenn eine definiert ist. Wenn keine benutzerdefinierte Fehlerseite für den empfangenen Fehler definiert ist, wird eine IIS-Fehlerseite angezeigt.
1	`On`	Eine benutzerdefinierte ASP.NET benutzerdefinierte Fehlerseite wird sowohl für lokale als auch für Remotebenutzer angezeigt.
2	`Off`	Die Standardmäßige ASP.NET Fehlerseite wird sowohl für lokale als auch für Remotebenutzer angezeigt.

Beispiel

Im folgenden Beispiel wird die DefaultRedirect-Eigenschaft auf „CustomError.htm“ und die Mode-Eigenschaft auf On gesetzt.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the custom errors section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CustomErrorsSection", oSection  
  
' Set the default redirect page to CustomError.htm,  
' and set the Mode property to On.  
oSection.DefaultRedirect = "CustomError.htm"  
oSection.Mode = 1  
oSection.Put_

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

CustomErrorsSection

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

ConfigurationSectionWithCollection-Klasse
CustomError-Klasse
HttpErrorElement-Klasse
HttpErrorsSection-Klasse

Freigeben über