customErrors, élément (Schéma des paramètres ASP.NET)
Mise à jour : novembre 2007
Fournit des informations sur les messages d'erreur personnalisés pour une application ASP.NET. L'élément customErrors peut être défini à n'importe quel niveau de la hiérarchie des fichiers d'application.
<configuration>, élément
system.web, élément (Schéma des paramètres ASP.NET)
Élément <customErrors>
<customErrors defaultRedirect="url"
mode="On|Off|RemoteOnly">
<error. . ./>
</customErrors>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Attribut |
Description |
||||||||
|---|---|---|---|---|---|---|---|---|---|
defaultRedirect |
Attribut facultatif. Spécifie l'URL par défaut vers laquelle rediriger un navigateur si une erreur se produit. Lorsque cet attribut n'est pas spécifié, une erreur générique s'affiche. Il peut s'agir d'une URL absolue (par exemple, www.contoso.com/ErrorPage.htm) ou relative. Une URL relative, par exemple /ErrorPage.htm, est relative au fichier Web.config qui a spécifié l'URL pour cet attribut et non à la page Web dans laquelle l'erreur s'est produite. Une URL qui commence par un tilde (~), par exemple ~/ErrorPage.htm, indique que l'URL spécifiée est relative au chemin d'accès racine de l'application. |
||||||||
mode |
Attribut requis. Spécifie si les erreurs personnalisées sont activées, désactivées ou visibles uniquement pour les clients distants. Cet attribut peut avoir l'une des valeurs suivantes :
La valeur par défaut est RemoteOnly. |
Éléments enfants
Élément |
Description |
|---|---|
error |
Élément facultatif. Spécifie la page d'erreur personnalisée pour un code d'état HTTP donné. La balise error peut apparaître plusieurs fois. Chaque occurrence définit une condition d'erreur personnalisée. |
Éléments parents
Élément |
Description |
|---|---|
configuration |
Spécifie l'élément racine dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework. |
system.web |
Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications. |
Notes
L'élément <customErrors> ne s'applique pas aux erreurs qui se produisent dans les services Web XML.
Configuration par défaut
L'élément customErrors par défaut est configuré dans le fichier Machine.config des versions 1.0 et 1.1 du .NET Framework.
<customErrors mode="RemoteOnly" />
Exemple
L'exemple de configuration suivant montre comment spécifier les pages de gestion des erreurs à utiliser pour une application ASP.NET.
<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 |
|
Membre de configuration |
|
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
system.web, élément (Schéma des paramètres ASP.NET)
configuration, élément (Schéma des paramètres généraux)
error, élément de customErrors (Schéma des paramètres ASP.NET)
Autres ressources
Fichiers de configuration ASP.NET
Paramètres de configuration ASP.NET