customErrors-Element (ASP.NET-Einstellungsschema)

Artikel
08/10/2011

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>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
defaultRedirect	Optionales Attribut. Gibt die Standard-URL an, an die ein Browser im Falle eines Fehlers umgeleitet wird. Wenn dieses Attribut nicht angegeben ist, wird stattdessen eine allgemeine Fehlermeldung angezeigt. Die URL kann absolut (z. B. www.contoso.com/ErrorPage.htm) oder relativ angegeben werden. Eine relative URL wie /ErrorPage.htm verweist auf einen Ort relativ zur Datei Web.config, in der die URL für dieses Attribut angegeben wurde, nicht auf einen Ort relativ zur Webseite, in der der Fehler aufgetreten ist. Eine URL, die mit einer Tilde (~) beginnt (z. B. ~/ErrorPage.htm), gibt an, dass die 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. Dieses Attribut kann einen der folgenden Werte annehmen. WertBeschreibung 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. Der Standardwert ist RemoteOnly.
redirectMode	Optionales Attribut. Gibt Werte für die Behandlung der URL der ursprünglichen Anforderung bei Anzeige einer Fehlerseite an. Dieses Attribut kann einen der folgenden Werte annehmen. ValueBeschreibungen ResponseRedirect Gibt an, dass die URL, an die der Browser verwiesen wird, sich von der ursprünglichen Webanforderungs-URL unterscheiden muss. ResponseRewrite Gibt an, dass die URL, an die der Browser verwiesen wird, die ursprüngliche Webanforderungs-URL sein muss.

defaultRedirect

Optionales Attribut.

Gibt die Standard-URL an, an die ein Browser im Falle eines Fehlers umgeleitet wird. Wenn dieses Attribut nicht angegeben ist, wird stattdessen eine allgemeine Fehlermeldung angezeigt.

Die URL kann absolut (z. B. www.contoso.com/ErrorPage.htm) oder relativ angegeben werden. Eine relative URL wie /ErrorPage.htm verweist auf einen Ort relativ zur Datei Web.config, in der die URL für dieses Attribut angegeben wurde, nicht auf einen Ort relativ zur Webseite, in der der Fehler aufgetreten ist. Eine URL, die mit einer Tilde (~) beginnt (z. B. ~/ErrorPage.htm), gibt an, dass die 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.

Dieses Attribut kann einen der folgenden Werte annehmen.

WertBeschreibung

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.

Der Standardwert ist RemoteOnly.

redirectMode

Optionales Attribut.

Gibt Werte für die Behandlung der URL der ursprünglichen Anforderung bei Anzeige einer Fehlerseite an.

Dieses Attribut kann einen der folgenden Werte annehmen.

ValueBeschreibungen

ResponseRedirect Gibt an, dass die URL, an die der Browser verwiesen wird, sich von der ursprünglichen Webanforderungs-URL unterscheiden muss.

ResponseRewrite Gibt an, dass die URL, an die der Browser verwiesen wird, die ursprüngliche Webanforderungs-URL sein muss.

Untergeordnete Elemente

Element	Beschreibungen
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.

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.

Übergeordnete Elemente

Element	Beschreibung
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.

Hinweise

Standardkonfiguration

Das folgende customErrors-Standardelement wird in der Datei Machine.config in .NET Framework, Version 1.0 und 1.1, konfiguriert.

<customErrors mode="RemoteOnly" />

Beispiel

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>

Elementinformationen

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

Siehe auch

Freigeben über

customErrors-Element (ASP.NET-Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen