<customErrors>, élément

Article
04/11/2008

Fournit des informations sur les messages d'erreur personnalisés pour une application ASP.NET.

<configuration>
<system.web>
<customErrors>

<customErrorsdefaultRedirect="url"              mode="On|Off|RemoteOnly">   <error statusCode="statuscode"          redirect="url"/></customErrors>

Attribut requis

Attribut	Option	Description
Mode		Spécifie si les erreurs personnalisées sont activées, désactivées ou visibles uniquement pour les clients distants.
	On	Spécifie que les erreurs personnalisées sont activées. Si aucun defaultRedirect n'est spécifié, les utilisateurs voient s'afficher une erreur générique.
	Off	Spécifie que les erreurs personnalisées sont désactivées. Cela permet l'affichage d'erreurs détaillées.
	RemoteOnly	Spécifie que les erreurs personnalisées ne sont visibles que pour les clients distants et les erreurs ASP.NET sont affichées à l'hôte local. Il s'agit de l'option par défaut.

Attribut facultatif

Attribut	Description
defaultRedirect	Spécifie l'URL par défaut vers laquelle un navigateur sera redirigé si une erreur se produit. Lorsque defaultRedirect n'est pas spécifié, une erreur générique s'affiche. L'URL peut être absolue (par exemple, https://www.contoso.com/ErrorPage.htm) ou relative. Une URL relative comme par exemple /ErrorPage.htm est relative au fichier Web.config qui spécifie l'URL defaultRedirect. Elle n'est pas relative à la page Web page où l'erreur s'est produite. Une URL qui commence par un tilde (~) comme par exemple ~/ErrorPage.htm, signifie que l'URL spécifiée est relative au chemin d'accès racine de l'application.

defaultRedirect

Spécifie l'URL par défaut vers laquelle un navigateur sera redirigé si une erreur se produit. Lorsque defaultRedirect n'est pas spécifié, une erreur générique s'affiche. L'URL peut être absolue (par exemple, https://www.contoso.com/ErrorPage.htm) ou relative. Une URL relative comme par exemple /ErrorPage.htm est relative au fichier Web.config qui spécifie l'URL defaultRedirect. Elle n'est pas relative à la page Web page où l'erreur s'est produite. Une URL qui commence par un tilde (~) comme par exemple ~/ErrorPage.htm, signifie que l'URL spécifiée est relative au chemin d'accès racine de l'application.

Sous-balise

Sous-balise	Description
<error>	La sous-balise error peut apparaître plusieurs fois. Chaque occurrence définit une condition d'erreur personnalisée.

Notes

L'élément <customErrors> ne s'applique pas aux erreurs qui se produisent dans les services Web XML.

Exemple

L'exemple suivant spécifie 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>

Configuration requise

Contenu dans : <system.web>

Plate-forme Web : IIS 5.0, IIS 5.1, IIS 6.0

Fichier de configuration : Machine.config, Web.config

Gestionnaire de sections de configuration : System.Web.Configuration.CustomErrorsConfigHandler

Voir aussi

Configuration ASP.NET | Schéma des paramètres ASP.NET

Partager via