Aktualisiert: November 2007
Enthält Informationen zu benutzerdefinierten Fehlermeldungen für eine ASP.NET-Anwendung. Das customErrors-Element kann auf jeder Ebene der Anwendungsdateihierarchie definiert werden.
<customErrors defaultRedirect="url" mode="On|Off|RemoteOnly"> <error. . ./> </customErrors>
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribut
Beschreibung
defaultRedirect
Optionales Attribut
Gibt den Standard-URL an, an den ein Browser im Falle eines Fehlers umgeleitet wird. Wenn dieses Attribut nicht angegeben ist, wird stattdessen eine allgemeine Fehlermeldung angezeigt.
Der URL kann absolut (z. B. www.contoso.com/ErrorPage.htm) oder relativ angegeben werden. Ein relativer URL wie /ErrorPage.htm verweist auf einen Ort relativ zur Datei Web.config, in der der URL für dieses Attribut angegeben wurde, nicht auf einen Ort relativ zur Webseite, in der der Fehler aufgetreten ist. Ein URL, der mit einer Tilde (~) beginnt (z. B. ~/ErrorPage.htm), gibt an, dass der angegebene URL auf einen Ort relativ zum Stammverzeichnis der Anwendung verweist.
mode
Erforderliches Attribut
Gibt an, ob benutzerdefinierte Fehlermeldungen aktiviert bzw. deaktiviert oder nur für Remoteclients angezeigt werden.
Das Attribut kann einen der folgenden Werte annehmen.
Wert
On
Gibt an, dass benutzerdefinierte Fehlermeldungen aktiviert sind. Wenn kein defaultRedirect-Attribut angegeben ist, wird eine allgemeine Fehlermeldung ausgegeben. Die benutzerdefinierten Fehlermeldungen werden für die Remoteclients und den lokalen Host angezeigt.
Off
Gibt an, dass benutzerdefinierte Fehlermeldungen deaktiviert sind. Die detaillierten ASP.NET-Fehlermeldungen werden für die Remoteclients und den lokalen Host angezeigt.
RemoteOnly
Gibt an, dass benutzerdefinierte Fehlermeldungen nur für die Remoteclients angezeigt werden und dass ASP.NET-Fehlermeldungen für den lokalen Host angezeigt werden. Dies ist der Standardwert.
Als Standardwert gilt RemoteOnly.
Element
error
Optionales Element
Gibt die benutzerdefinierte Fehlerseite für den angegebenen HTTP-Statuscode an.
Das error-Tag kann mehrmals vorkommen. Jedes Vorkommen definiert eine benutzerdefinierte Fehlerbedingung.
configuration
Gibt das 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 die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an und enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.
Das <customErrors>-Element bezieht sich nicht auf Fehler, die in XML-Webdiensten auftreten.
Das folgende customErrors-Standardelement wird in der Datei Machine.config in .NET Framework, Version 1.0 und 1.1, konfiguriert.
<customErrors mode="RemoteOnly" />
Im folgenden Konfigurationsbeispiel wird gezeigt, wie die für eine ASP.NET-Anwendung zu verwendenden Fehlerbehandlungsseiten angegeben werden.
<configuration> <system.web> <customErrors defaultRedirect="GenericError.htm" mode="RemoteOnly"> <error statusCode="500" redirect="InternalError.htm"/> </customErrors> </system.web> </configuration>
Konfigurationsabschnittshandler
System.Web.Configuration..::.CustomErrorsSection
Konfigurationsmember
SystemWebSectionGroup..::.CustomErrors
System.Web.Configuration..::.CustomErrorsMode
Konfigurierbare Speicherorte
Machine.config
Web.config auf der Stammebene
Web.config auf der Anwendungsebene
Web.config auf der Ebene virtueller oder physikalischer 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