<customErrors>-Element

Artikel
03/31/2008

Enthält Informationen zu benutzerdefinierten Fehlermeldungen für eine ASP.NET-Anwendung.

<configuration>
<system.web>
<customErrors>

<customErrorsdefaultRedirect="url"              mode="On|Off|RemoteOnly">   <error statusCode="statuscode"          redirect="url"/></customErrors>

Erforderliches Attribut

Attribut	Option	Beschreibung
Mode		Gibt an, ob benutzerdefinierte Fehlermeldungen aktiviert bzw. deaktiviert oder nur für Remoteclients angezeigt werden.
	On	Gibt an, dass benutzerdefinierte Fehlermeldungen aktiviert sind. Wenn defaultRedirect nicht angegeben ist, wird eine allgemeine Fehlermeldung ausgegeben.
	Off	Gibt an, dass benutzerdefinierte Fehlermeldungen deaktiviert sind. Dies ermöglicht die Anzeige detaillierter Fehler.
	RemoteOnly	Gibt an, dass die Ausgabe benutzerdefinierter Fehler nur für Remoteclients und die Ausgabe von ASP.NET-Fehlern für den lokalen Host erfolgt. Dies ist die Standardeinstellung.

Optionales Attribut

Attribut	Beschreibung
defaultRedirect	Gibt den standardmäßigen URL an, an den ein Browser im Falle eines Fehlers umgeleitet wird. Wenn defaultRedirect nicht angegeben ist, wird stattdessen eine allgemeine Fehlermeldung angezeigt. Der URL kann absolut (z. B. https://www.contoso.com/ErrorPage.htm) oder relativ sein. Ein relativer URL wie /ErrorPage.htm ist relativ zur Datei Web.config, in der der defaultRedirect-URL angegeben wurde, und nicht zur Webseite, in der der Fehler aufgetreten ist. Ein URL, der mit einer Tilde (~) beginnt (z. B. ~/ErrorPage.htm), bedeutet, dass der angegebene URL relativ zum Stammverzeichnis der Anwendung ist.

defaultRedirect

Gibt den standardmäßigen URL an, an den ein Browser im Falle eines Fehlers umgeleitet wird. Wenn defaultRedirect nicht angegeben ist, wird stattdessen eine allgemeine Fehlermeldung angezeigt. Der URL kann absolut (z. B. https://www.contoso.com/ErrorPage.htm) oder relativ sein. Ein relativer URL wie /ErrorPage.htm ist relativ zur Datei Web.config, in der der defaultRedirect-URL angegeben wurde, und nicht zur Webseite, in der der Fehler aufgetreten ist. Ein URL, der mit einer Tilde (~) beginnt (z. B. ~/ErrorPage.htm), bedeutet, dass der angegebene URL relativ zum Stammverzeichnis der Anwendung ist.

Untertag

Untertag	Beschreibung
<error>	Der Untertag error kann mehrmals vorkommen. Jedes Vorkommen definiert eine benutzerdefinierte Fehlerbedingung.

Hinweise

Das <customErrors>-Element bezieht sich nicht auf Fehler, die in XML-Webdiensten auftreten.

Beispiel

Im folgenden Beispiel werden die für eine ASP.NET-Anwendung zu verwendenden Fehlerbehandlungsseiten angegeben.

<configuration>
   <system.web>
      <customErrors defaultRedirect="GenericError.htm"
                    mode="RemoteOnly">
         <error statusCode="500"
                redirect="InternalError.htm"/>
      </customErrors>
   </system.web>
</configuration>

Anforderungen

Enthalten in: <system.web>

Webplattform: IIS 5.0, IIS 5.1, IIS 6.0

Konfigurationsdatei: Machine.config, Web.config

Konfigurationsabschnittshandler: System.Web.Configuration.CustomErrorsConfigHandler

Siehe auch

ASP.NET-Konfiguration | ASP.NET-Einstellungsschema

Freigeben über