CustomError-Klasse

Artikel
03/25/2024

Gibt eine ASP.NET benutzerdefinierte Fehlermeldung für einen HTTP-Statuscodefehler an.

Syntax

class CustomError : CollectionElement

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

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

Name	Beschreibung
`Redirect`	Ein erforderlicher Wert, der keinen Wert mit Lese-/Schreibzugriff `string` enthält, der den Pfad einer Datei oder URL enthält, die eine benutzerdefinierte Fehlermeldung enthält.
`StatusCode`	Ein erforderlicher eindeutiger Lese-/Schreibwert `sint32`, der einen HTTP-Fehlerstatuscode angibt. Die gültigen Werte sind 100 bis 999. Die Schlüsseleigenschaft.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der CustomErrors-Eigenschaft der CustomErrorsSection-Klasse enthalten.

Die von der CustomError-Klasse dargestellten benutzerdefinierten Fehler sind spezifisch für ASP.NET und befinden sich im <system.web>-Abschnitt der Web.config-Datei. Die benutzerdefinierten Fehler, die durch die HttpErrorElement-Klasse dargestellt werden, sind spezifisch für IIS 7 und befinden sich im <system.webServer>-Abschnitt der ApplicationHost.config-Datei.

Beispiel

Im folgenden Beispiel wird dem Abschnitt „Benutzerdefinierte Fehler“ der Standardwebsite ein benutzerdefinierter Fehler hinzugefügt.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the CustomError class object.  
Set oCustomError = oWebAdmin.Get("CustomError")  
  
' Create a new instance of the CustomError class.  
Set oNewCustomError = oCustomError.SpawnInstance_  
  
' Assign values to the StatusCode and Redirect properties.  
oNewCustomError.StatusCode = 404  
oNewCustomError.Redirect ="CustomPageNotFoundError.htm"  
  
' Get the custom errors section for the default Web site.   
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CustomErrorsSection", oCustomErrorsSection  
  
' Call the CustomErrorsSection.Add method to add the custom error.  
oCustomErrorsSection.Add "CustomErrors", oNewCustomError

Vererbungshierarchie

CollectionElement

CustomError

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

CollectionElement-Klasse
CustomErrorsSection-Klasse
HttpErrorElement-Klasse
HttpErrorsSection-Klasse

Freigeben über