Partager via

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

  • Article

Mise à jour : novembre 2007

Spécifie la page d'erreurs personnalisée pour un code d'état HTTP donné.

<configuration>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    customErrors, élément (Schéma des paramètres ASP.NET)
      error, élément de customErrors (Schéma des paramètres ASP.NET)

<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 IIS émet 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

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

Fonctionnalités des contrôles serveur Web ASP.NET et du navigateur

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

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

Autres ressources

Fichiers de configuration ASP.NET

Paramètres de configuration ASP.NET

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

API de configuration ASP.NET