Share via


error, élément de customErrors (Schéma des paramètres ASP.NET)

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Spécifie la page d'erreur personnalisée correspondant à un code d'état HTTP donné.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

statusCode

Attribut requis.

Spécifie le code d'état HTTP qui entraîne une redirection vers la page d'erreurs.

redirect

Attribut requis.

URL de la page personnalisée mappée au code d'erreur.

Éléments enfants

Aucun

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine de la section de configuration ASP.NET.

customErrors

Fournit des informations sur les messages d'erreur personnalisés pour une application ASP.NET. Il peut être défini à tout niveau dans la hiérarchie des fichiers d'application.

Exemple

L'exemple de code de configuration suivant spécifie les pages de gestion des erreurs à utiliser pour une application ASP.NET.

Les erreurs personnalisées sont émises uniquement pour les éléments gérés par ASP.NET. Par exemple, si vous faites référence à une page .htm inexistante, Microsoft Internet Information Services (IIS) génère l'erreur 404 standard. Si, au lieu de cela, vous faites référence à une page .aspx inexistante, ASP.NET publie l'erreur 404 personnalisée, dans le cas où vous avez configuré l'erreur.

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

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.CustomErrorsSection

Membre de configuration

System.Web.Configuration.CustomErrorsMode

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Web.config de niveau répertoire virtuel ou physique

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Tâches

How to: Lock ASP.NET Configuration Settings

Référence

customErrors, élément (Schéma des paramètres ASP.NET)

system.web, élément (Schéma des paramètres ASP.NET)

configuration, élément (Schéma des paramètres généraux)

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Autres ressources

ASP.NET Configuration Files

Paramètres de configuration ASP.NET

Paramètres généraux de configuration (ASP.NET)

ASP.NET Configuration API