HttpErrorElement-Klasse
Konfiguriert die Antwort auf einen bestimmten HTTP-Fehler.
Syntax
class HttpErrorElement : CollectionElement
Methoden
Diese Klasse enthält keine Methoden.
Eigenschaften
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der HttpErrorElementKlasse verfügbar gemacht werden.
| Name | Beschreibung |
|---|---|
Path |
Ein erforderlicher Lese-/Schreibstring-Wert, der den Dateinamen oder die URL enthält, die als Reaktion auf den HTTP-Fehler, wie er in den Eigenschaften StatusCode und SubStatusCode angegeben ist, bereitgestellt werden.. |
PrefixLanguageFilePath |
Ein optionaler Lese-/Schreibstring-Wert, der den physischen Pfad eines benutzerdefinierten Fehlerseitenverzeichnisses angibt. Das Verzeichnis der benutzerdefinierten Fehlerseite enthält ein oder mehrere sprachspezifische Unterverzeichnisse mit benutzerdefinierten Fehlerseiten für den in der StatusCode Eigenschaft angegebenen Fehler.Der Dateipfad wird wie folgt erstellt: PrefixLanguageFilePath\ClientLanguageID\CustomErrorPageFile. Beispielsweise kann "PrefixLanguageFilePath "sein, "%SystemDrive%\inetpub\custerr", "ClientLanguageID " könnte "en-us" sein und CustomErrorPageFile (durch die Path Eigenschaft angegeben) "401.htm" sein. Hinweis: Benutzerdefinierte Fehler sind sprachspezifisch und geben in der Regel den benutzerdefinierten Fehler in der Systemsprache des Clients zurück. Damit eine Fehlerseite in einer anderen Sprache als die Systemsprache des Clients zurückgegeben wird, muss das Sprachpaket für diese Sprache auf dem Client installiert werden. Wenn z.B. "PrefixLanguageFilePath " "d:\inetpub\custerr" lautet und der Client das en-US-Sprachpaket installiert hat, lautet der resultierende Pfad für Fehlercode 404 d:\inetpub\custerr\en-us\404.htm, wenn der Clientbrowser "en-us" in der Accept-Language Kopfzeile sendet. Wenn ja-JP jedoch die Systemsprache und das en-US-Sprachpaket nicht installiert ist, lautet der resultierende Pfad "d:\inetpub\custerr\ja-jp\404.htm". |
ResponseMode |
Ein erforderlicher Lese-/Schreibsint32-Wert, der die Antwort auf den durch StatusCodeund SubStatusCode spezifizierten HTTP-Fehler angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt. |
StatusCode |
Ein erforderlicher eindeutiger Lese-/Schreibuint32-Wert, der einen Statuscode von 400 bis 999 enthält. Eine Schlüsseleigenschaft. |
SubStatusCode |
Ein erforderlicher eindeutiger Lese-/Schreibsint32-Wert, der einen Unterstatuscode von –1 bis 999 enthält. Der Standardwert beträgt 1. Eine Schlüsseleigenschaft. |
Unterklassen
Diese Klasse enthält keine Unterklassen.
Hinweise
Instanzen dieser Klasse sind in der HttpErrors Arrayeigenschaft der HttpErrorsSection-Klasse enthalten.
Diese Klasse stellt ein <error> Element im <httpErrors> Abschnitt der ApplicationHost.config-Datei dar.
Die folgende Tabelle enthält die möglichen Werte und Schlüsselwörter für die ResponseMode Eigenschaft. Der Standardwert ist 0 (File).
| Wert | Schlüsselwort | Beschreibung |
|---|---|---|
| 0 | File |
Der Webserver gibt die in der Path Eigenschaft angegebene Webseite zurück. |
| 1 | ExecuteURL |
Der Webserver gibt die in Pathangegebene ASP-Seite zurück. |
| 2 | Redirect |
Der Webserver leitet die Anforderung an die in Pathangegebene URL um. |
Vererbungshierarchie
HttpErrorElement
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
HttpErrorsSection-Klasse
Konfigurieren von benutzerdefinierten Fehlermeldungen
IIS-Statuscodes