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