error-Element für customErrors (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Gibt die benutzerdefinierte Fehlerseite für den angegebenen HTTP-Statuscode an.
<error statusCode="statuscode"
redirect="url"/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
statusCode |
Erforderliches Attribut. Gibt den HTTP-Statuscode an, der die Umleitung zur Fehlerseite auslöst. |
redirect |
Erforderliches Attribut. Die URL der benutzerdefinierten Seite, die dem Fehlercode zugeordnet wird. |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
system.web |
Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an. |
customErrors |
Enthält Informationen zu benutzerdefinierten Fehlermeldungen für eine ASP.NET-Anwendung. Es kann auf jeder Ebene der Anwendungsdateihierarchie definiert werden. |
Beispiel
Im folgenden Codebeispiel werden die für eine ASP.NET-Anwendung zu verwendenden Fehlerbehandlungsseiten angegeben.
Die benutzerdefinierten Fehler werden nur für von ASP.NET behandelte Elemente ausgegeben. Wenn beispielsweise auf eine nicht vorhandene HTM-Seite verwiesen wird, gibt Microsoft Internetinformationsdienste (IIS) den standardmäßigen Fehler 404 aus. Wenn Sie dagegen auf eine nicht vorhandene ASPX-Seite verweisen, gibt ASP.NET den benutzerdefinierten Fehler 404 aus. Voraussetzung hierfür ist, dass Sie den Fehler konfiguriert haben.
<configuration>
<system.web>
<customErrors defaultRedirect="GenericError.htm"
mode="RemoteOnly">
<error statusCode="500"
redirect="InternalError.htm"/>
</customErrors>
</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 physischer 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
How to: Lock ASP.NET Configuration Settings
Referenz
customErrors-Element (ASP.NET-Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
Konzepte
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Weitere Ressourcen
ASP.NET-Konfigurationseinstellungen