error-Element für customErrors (ASP.NET-Einstellungsschema)

Aktualisiert: November 2007

Gibt die benutzerdefinierte Fehlerseite für einen angegebenen HTTP-Statuscode an.

<configuration>-Element
  system.web-Element (ASP.NET-Einstellungsschema)
    customErrors-Element (ASP.NET-Einstellungsschema)
      error-Element für customErrors (ASP.NET-Einstellungsschema)

<error statusCode="statuscode"
       redirect="url"/>

Attribute und Elemente

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

Attribute

Attribut

Beschreibung

statusCode

Erforderliches Attribut

Gibt den HTTP-Statuscode an, der die Umleitung zur Fehlerseite auslöst.

redirect

Erforderliches Attribut

Der 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

System.Web.Configuration.CustomErrorsSection

Konfigurationsmember

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

Aufgaben

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Konzepte

Übersicht über die ASP.NET-Konfiguration

ASP.NET-Webserversteuerelemente und Browserfunktionen

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Referenz

customErrors-Element (ASP.NET-Einstellungsschema)

system.web-Element (ASP.NET-Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

System.Configuration

System.Web.Configuration

Weitere Ressourcen

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurationseinstellungen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurations-API