Classe CustomError

Article
03/19/2024

Spécifie un message d’erreur personnalisé ASP.NET pour une erreur de code d’état HTTP.

Syntaxe

class CustomError : 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 CustomError.

Nom	Description
`Redirect`	Valeur de lecture/écriture `string` vide requise qui contient le chemin d’accès d’un fichier ou d’une URL qui contient un message d’erreur personnalisé.
`StatusCode`	Valeur de lecture/écriture `sint32` unique requise qui spécifie un code d’état d’erreur HTTP. Les valeurs valides sont comprises entre 100 et 999. La propriété clé.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les instances de cette classe sont contenues dans la propriété CustomErrors de la classe CustomErrorsSection.

Les erreurs personnalisées représentées par la classe CustomError sont spécifiques à ASP.NET et se trouvent dans la section <system.web> du fichier Web.config. Les erreurs personnalisées représentées par la classe HttpErrorElement sont spécifiques à IIS 7 et se trouvent dans la section <system.webServer> du fichier ApplicationHost.config.

Exemple

L’exemple suivant ajoute une erreur personnalisée à la section erreurs personnalisées du site Web par défaut.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the CustomError class object.  
Set oCustomError = oWebAdmin.Get("CustomError")  
  
' Create a new instance of the CustomError class.  
Set oNewCustomError = oCustomError.SpawnInstance_  
  
' Assign values to the StatusCode and Redirect properties.  
oNewCustomError.StatusCode = 404  
oNewCustomError.Redirect ="CustomPageNotFoundError.htm"  
  
' Get the custom errors section for the default Web site.   
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CustomErrorsSection", oCustomErrorsSection  
  
' Call the CustomErrorsSection.Add method to add the custom error.  
oCustomErrorsSection.Add "CustomErrors", oNewCustomError

Hiérarchie d'héritage

CollectionElement

CustomError

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur 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 CustomErrorsSection
Classe HttpErrorElement
Classe HttpErrorsSection

Partager via