Classe HttpErrorElement
Configure la réponse à une erreur HTTP spécifique.
Syntaxe
class HttpErrorElement : CollectionElement
Méthodes
Cette classe ne contient pas de méthodes.
Propriétés
Le tableau suivant répertorie les propriétés exposées par la classe HttpErrorElement.
| Nom | Description |
|---|---|
Path |
Valeur string de lecture/écriture requise qui contient le nom de fichier ou l'URL qui est servi en réponse à l'erreur HTTP spécifiée par les propriétés StatusCode et SubStatusCode. |
PrefixLanguageFilePath |
Valeur string de lecture/écriture facultative qui spécifie le chemin d'accès physique d'un répertoire de page d'erreurs personnalisée. Le répertoire de la page d'erreurs personnalisée contient un ou plusieurs sous-répertoires spécifiques à la langue avec des pages d'erreurs personnalisées pour l'erreur spécifiée dans la propriété StatusCode.Le chemin d'accès au fichier est construit comme suit : PrefixLanguageFilePath\ClientLanguageID\CustomErrorPageFile. Par exemple, PrefixLanguageFilePath peut être « %SystemDrive%\inetpub\custerr », ClientLanguageID peut être « en-us » et CustomErrorPageFile (spécifié par la propriété Path) peut être « 401.htm ». Remarque :les erreurs personnalisées sont spécifiques à une langue et renvoient généralement l'erreur personnalisée dans la langue système du client. Pour qu'une page d'erreur soit renvoyée dans une langue différente de la langue système du client, le module linguistique correspondant à cette langue doit être installé sur le client. Par exemple, si PrefixLanguageFilePath est « d:\inetpub\custerr » et que le client dispose du module linguistique en-US installé, le chemin obtenu pour le code d'erreur 404 est d:\inetpub\custerr\en-us\404.htm lorsque le navigateur client envoie « en-us » dans l'en-tête Accept-Language. Toutefois, si ja-JP est la langue du système et que le module linguistique en-US n'est pas installé, le chemin d'accès résultant est d:\inetpub\custerr\ja-jp\404.htm. |
ResponseMode |
Valeur sint32 de lecture/écriture requise qui spécifie la réponse à l'erreur HTTP spécifiée par StatusCode et SubStatusCode. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
StatusCode |
Valeur uint32 de lecture/écriture unique requise qui contient un code d'état de 400 à 999. Une propriété clé. |
SubStatusCode |
Valeur sint32 de lecture/écriture unique requise qui contient un code de sous-état de –1 à 999. La valeur par défaut est –1. Une propriété clé. |
Sous-classes
Cette classe ne contient aucune sous-classe.
Notes
Les instances de cette classe sont contenues dans la propriété de tableau HttpErrors de la classe HttpErrorsSection.
Cette classe représente un élément <error> dans la section <httpErrors> du fichier ApplicationHost.config.
Le tableau suivant contient les valeurs possibles et les mots-clés pour la propriété ResponseMode. La valeur par défaut est 0 (File).
| Valeur | Mot clé | Description |
|---|---|---|
| 0 | File |
Le serveur web retourne la page web spécifiée dans la propriété Path. |
| 1 | ExecuteURL |
Le serveur web retourne la page ASP spécifiée dans Path. |
| 2 | Redirect |
Le serveur web redirige la requête vers l'URL spécifiée dans Path. |
Hiérarchie d'héritage
HttpErrorElement
Spécifications
| Type | Description |
|---|---|
| Client | - IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sur 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 sur 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 CollectionElement
Classe HttpErrorsSection
Configuration des messages d'erreur personnalisés
Codes d'état IIS