Microsoft.com
Bienvenue Connexion
Centre .NET Framework
Cliquez pour évaluer et commenter
MSDN
MSDN Library
Développement .NET
Versions précédentes
.NET Framework 3.0
Référence génér...
Référence technique
Référence ASP.NET
<system.web>
<customErrors>

  Passer à l'affichage pour faible bande passante
Cette page est spécifique à
.NET Framework 3.0

D'autres versions sont également disponibles pour :
Référence générale du .NET Framework
customErrors, élément (Schéma des paramètres ASP.NET)

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.

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

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 :

Valeur Description

On

Spécifie que les erreurs personnalisées sont activées. Si aucun attribut defaultRedirect n'est spécifié, les utilisateurs voient s'afficher une erreur générique. Les erreurs personnalisées sont montrées aux clients distants et à l'hôte local.

Off

Spécifie que les erreurs personnalisées sont désactivées. Les erreurs ASP.NET détaillées sont montrées aux clients distants et à l'hôte local.

RemoteOnly

Spécifie que les erreurs personnalisées ne sont visibles que pour les clients distants et les erreurs ASP.NET sont montrées à l'hôte local. Valeur par défaut.

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.

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

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" />

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>

Gestionnaire de section de configuration

System.Web.Configuration.CustomErrorsSection

Membre de configuration

System.Web.Configuration.SystemWebSectionGroup.CustomErrors

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
Contenu de la communauté   Qu'est-ce que le Contenu de la communauté ?
Ajouter du contenu RSS  Annotations
© 2009 Microsoft Corporation. Tous droits réservés. Conditions d'utilisation  |  Marques  |  Confidentialité
Page view tracker