Partager via


Classe CustomErrorsSection

Configure les messages d'erreur personnalisés ASP.NET.

Syntaxe

class CustomErrorsSection : ConfigurationSectionWithCollection  

Méthodes

Le tableau suivant répertorie les méthodes présentées par la classe CustomErrorsSection.

Nom Description
Ajouter (Hérité de ConfigurationSectionWithCollection.)
Clear (Hérité de ConfigurationSectionWithCollection.)
Get (Hérité de ConfigurationSectionWithCollection.)
GetAllowDefinition (Hérité de ConfigurationSection.)
GetAllowLocation (Hérité de ConfigurationSection.)
Remove (Hérité de ConfigurationSectionWithCollection.)
RevertToParent (Hérité de ConfigurationSection.)
SetAllowDefinition (Hérité de ConfigurationSection.)
SetAllowLocation (Hérité de ConfigurationSection.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe CustomErrorsSection.

Nom Description
CustomErrors Tableau de valeurs CustomError qui définissent les erreurs personnalisées ASP.NET.
DefaultRedirect Valeur string obligatoire et non vide en lecture/écriture qui contient le chemin d’accès par défaut d’un fichier de message d’erreur HTTP ou l’URL d’un message d’erreur. Cette valeur est héritée par la propriété Redirect des objets CustomError nouvellement créés.
Location (Hérité de ConfigurationSection.) Une propriété clé.
Mode Énumération sint32 en lecture/écriture qui définit si les pages d’erreur personnalisées ou par défaut sont affichées localement ou à distance. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
Path (Hérité de ConfigurationSection.) Une propriété clé.
SectionInformation (Hérité de ConfigurationSection.)

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les erreurs personnalisées représentées par la classe CustomErrorsSection sont spécifiques à ASP.NET et se trouvent dans la section <system.web> du fichier Web.config. Chacune de ces erreurs est représentée par une instance de la classe CustomError.

Les erreurs personnalisées représentées par la classe HttpErrorsSection sont liées à IIS 7 et se trouvent dans la section <system.webServer> du fichier ApplicationHost.config. Chacune de ces erreurs est représentée par une instance de la classe HttpErrorElement. L’intégration de ASP.NET à IIS dans IIS 7 a apporté cette modification de nom nécessaire.

Le tableau suivant répertorie les valeurs possibles pour la propriété Mode. La valeur par défaut est 0 (RemoteOnly).

Valeur Mot clé Description
0 RemoteOnly La page d’erreur ASP.NET par défaut s’affiche aux utilisateurs locaux. Les utilisateurs distants recevront une page d’erreur personnalisée si un utilisateur est défini. Si aucune page d’erreur personnalisée n’est définie pour l’erreur reçue, une page d’erreur IIS s’affiche.
1 On Une page d’erreur personnalisée définie par l’utilisateur ASP.NET s’affiche pour les utilisateurs locaux et distants.
2 Off La page d’erreur par défaut ASP.NET est affichée pour les utilisateurs locaux et distants.

Exemple

L’exemple suivant définit la propriété DefaultRedirect à « CustomError.htm » et la propriété Mode à On.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the custom errors section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CustomErrorsSection", oSection  
  
' Set the default redirect page to CustomError.htm,  
' and set the Mode property to On.  
oSection.DefaultRedirect = "CustomError.htm"  
oSection.Mode = 1  
oSection.Put_  
  

Hiérarchie d'héritage

ConfigurationSection

ConfigurationSectionWithCollection

CustomErrorsSection

Spécifications

Type Description
Client - IIS 7.0 sous Windows Vista
- IIS 7.5 sous Windows 7
- IIS 8.0 sous Windows 8
- IIS 10.0 sous Windows 10
Serveur - IIS 7.0 sous Windows Server 2008
- IIS 7.5 sous Windows Server 2008 R2
- IIS 8.0 sous Windows Server 2012
- IIS 8.5 sous Windows Server 2012 R2
- IIS 10.0 sous Windows Server 2016
Produit - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF WebAdministration.mof

Voir aussi

Classe ConfigurationSectionWithCollection
Classe CustomError
Classe HttpErrorElement
Classe HttpErrorsSection