Partager via

Erreurs personnalisées, onglet de la boîte de dialogue Paramètres de configuration ASP.NET

  • Article

Mise à jour : novembre 2007

Lorsqu'une erreur se produit dans une page ou un composant Web ASP.NET, ASP.NET déclenche un code d'erreur. Les erreurs peuvent être des types suivants :

  • Compilation.

  • Analyseur (éléments ASP.NET incorrects).

  • Configuration.

  • Exécution.

    Remarque :

    Le composant logiciel enfichable MMC pour ASP.NET fonctionne avec IIS 6.0 ou toute version antérieure. L'outil d'administration d'IIS 7.0 comprend les fonctionnalités de l'outil MMC ASP.NET. Pour plus d'informations, consultez Configuration ASP.NET et IIS.

Par défaut, ASP.NET génère dynamiquement une page d'erreur qui contient une description de l'erreur, le nom de la page sur laquelle l'erreur s'est produite et une trace de la pile. Si le mode débogage est activé, la page générée dynamiquement contient également un extrait du code source d'où provient l'erreur. En définissant des erreurs personnalisées, vous pouvez spécifier comment doit répondre l'application Web en cas d'erreur.

Remarque :

Pour plus d'informations sur le mode débogage, consultez Application, onglet de la boîte de dialogue Paramètres de configuration ASP.NET.

Pour afficher l'onglet Erreurs personnalisées de la boîte de dialogue Paramètres de configuration ASP.NET

  1. Dans Microsoft Windows, ouvrez Outils d'administration, puis cliquez sur Gestionnaire des services Internet (IIS).

    Le Gestionnaire des services Internet apparaît.

  2. Sous Services Internet (IIS), développez Servername(ordinateur local), développez Sites Web, cliquez avec le bouton droit sur Websitename ou Site Web par défaut, puis cliquez sur Propriétés.

    La boîte de dialogue Propriétés du site Web s'affiche.

  3. Cliquez sur l'onglet ASP.NET, puis cliquez sur Modifier la configuration.

    La boîte de dialogue Paramètres de configuration ASP.NET s'affiche.

  4. Cliquez sur Erreurs personnalisées.

Tâches

L'onglet Erreurs personnalisées vous permet d'effectuer les tâches suivantes :

  • Spécifier une page d'erreur par défaut à afficher lorsqu'une erreur ASP.NET se produit n'importe où dans l'application Web.

  • Mapper des codes d'erreur HTTP spécifiques avec les pages d'erreur correspondantes.

    Remarque :

    Les mappages fonctionnent uniquement pour les erreurs qui sont notifiées à ASP.NET. Par exemple, par défaut, les erreurs HTTP 404 (page non trouvée) ne sont pas notifiées à ASP.NET. Si vous souhaitez qu'ASP.NET reçoive ces erreurs, vous pouvez définir les propriétés du site Web pour qu'elles mappent les erreurs HTTP aux pages .aspx.

  • Spécifiez si les pages d'erreur personnalisées sont affichées pour tous les utilisateurs, aucun utilisateur ou les utilisateurs distants (autres que les administrateurs).

Éléments d'interface

  • Mode Erreurs personnalisées
    Cliquez sur un mode pour spécifier comment afficher les erreurs personnalisées, comme suit :

    • On   

      Les pages d'erreurs personnalisées s'affichent dans tous les cas. Utilisez ce paramètre pour voir les erreurs lors du développement de l'application Web.

    • Off   

      Les pages d'erreurs personnalisées ne s'affichent pas. À la place, les erreurs génèrent de manière dynamique une page d'erreur ASP.NET.

    • Remote Only   

      Les erreurs sont redirigées uniquement pour les demandes qui ne sont pas générées localement sur le serveur Web. Utilisez ce mode pour voir les erreurs ASP.NET lorsque vous travaillez sur le serveur, mais affichez les erreurs personnalisées pour les utilisateurs de l'application Web.

  • URL de redirection par défaut
    Indiquez le nom de la page (.aspx ou .htm) à afficher en réponse aux erreurs non gérées survenant n'importe où dans l'application Web.

  • Erreurs personnalisées héritées
    Répertorie les pages d'erreurs personnalisées héritées de fichiers de configuration situés plus hauts dans la hiérarchie. Vous pouvez substituer les paramètres d'erreurs héritées en ajoutant une erreur personnalisée locale pour le code d'état que vous souhaitez remplacer.

  • Erreurs personnalisées locales
    Répertorie les pages d'erreurs pour le site Web actuel, spécifiquement.

  • Ajouter
    Cliquez pour ouvrir la boîte de dialogue Modifier/ajouter des gestionnaires d'erreurs personnalisées où vous pouvez spécifier un code d'erreur HTTP et la page à afficher lorsque ASP.NET détecte l'erreur.

    Remarque :

    Les mappages fonctionnent uniquement pour les erreurs qui sont notifiées à ASP.NET. Par exemple, par défaut, les erreurs HTTP 404 (page non trouvée) ne sont pas notifiées à ASP.NET. Si vous souhaitez qu'ASP.NET reçoive ces erreurs, vous pouvez définir les propriétés du site Web pour qu'elles mappent les erreurs HTTP aux pages .aspx.

    Vous devez fournir le code d'erreur HTTP et l'URL de la page à laquelle il est mappé. La page que vous référencez ne doit pas faire obligatoirement partie du site Web actuel.

    Remarque :

    Le gestionnaire des services Internet (IIS) ne valide pas l'URL que vous saisissez.

  • Modifier
    Cliquez pour ouvrir la boîte de dialogue Modifier/ajouter un gestionnaire d'erreurs personnalisées où vous pouvez modifier le nom ou le code d'erreur de la page que vous avez sélectionnée sous Erreurs personnalisées locales.

  • Supprimer
    Cliquez sur cette option pour supprimer un mappage de page d'erreur.

Voir aussi

Tâches

Comment : accéder par programme aux paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

Référence

Authentification, onglet de la boîte de dialogue Paramètres de configuration ASP.NET

Autorisation, onglet de la boîte de dialogue Paramètres de configuration ASP.NET

Emplacements, onglet de la boîte de dialogue Paramètres de configuration ASP.NET

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

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