CustomError Classe

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Configure une section CustomError pour mapper un code d’erreur ASP.NET à une page personnalisée. Cette classe ne peut pas être héritée.

public ref class CustomError sealed : System::Configuration::ConfigurationElement

public sealed class CustomError : System.Configuration.ConfigurationElement

type CustomError = class
    inherit ConfigurationElement

Public NotInheritable Class CustomError
Inherits ConfigurationElement

Héritage

Object

ConfigurationElement

CustomError

Exemples

Cet exemple montre comment spécifier des valeurs de manière déclarative pour plusieurs attributs de la customErrors section, qui sont également accessibles en tant que membres de la CustomError classe.

L’exemple de fichier de configuration suivant montre comment spécifier des valeurs de manière déclarative pour la customErrors section.

<customErrors mode="RemoteOnly"
  defaultRedirect="customerror.htm">
    <error statusCode="404" redirect="customerror404.htm"/>
</customErrors>

L’exemple de code suivant montre comment utiliser la CustomError classe.

// Get the Web application configuration.
Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnetTest");

// Get the section.
CustomErrorsSection customErrors =
    (CustomErrorsSection)configuration.GetSection(
  "system.web/customErrors");

// Get the collection.
CustomErrorCollection customErrorsCollection =
    customErrors.Errors;

' Get the Web application configuration.
  Dim configuration _
  As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnetTest")

' Get the section.
  Dim customErrors As CustomErrorsSection = _
   CType(configuration.GetSection( _
   "system.web/customErrors"), CustomErrorsSection)

' Get the collection.
  Dim customErrorsCollection _
  As CustomErrorCollection = _
  customErrors.Errors

Remarques

La CustomError classe permet d’accéder par programmation et de modifier la error section d’un fichier de configuration. Ce type fait partie d’un groupe qui inclut le CustomErrorCollection, CustomErrorsModeet CustomErrorsSection.

Note

Lorsque vous définissez une erreur personnalisée, ASP.NET lui attribue l’erreur standard normalement émise par le service sous-jacent, par exemple IIS. Par exemple, si vous définissez une erreur personnalisée pour le code d’état 404, ASP.NET l’émettra chaque fois que vous faites référence à une page .aspx non existante. Les erreurs personnalisées sont émises uniquement pour ces éléments gérés par ASP.NET. Par exemple, si vous faites référence à une page .htm non existante, IIS émet l’erreur 404 standard.

Constructeurs

Nom	Description
CustomError(Int32, String)	Initialise une nouvelle instance de la classe CustomError.

Propriétés

Nom	Description
CurrentConfiguration	Obtient une référence à l’instance de niveau supérieur Configuration qui représente la hiérarchie de configuration à laquelle appartient l’instance ConfigurationElement actuelle. (Hérité de ConfigurationElement)
ElementInformation	Obtient un objet ElementInformation qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationElement. (Hérité de ConfigurationElement)
ElementProperty	Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement)
EvaluationContext	Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement)
HasContext	Obtient une valeur qui indique si la propriété CurrentConfiguration est null. (Hérité de ConfigurationElement)
Item[ConfigurationProperty]	Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement)
Item[String]	Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement)
LockAllAttributesExcept	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockAllElementsExcept	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockAttributes	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockElements	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockItem	Obtient ou définit une valeur indiquant si l’élément est verrouillé. (Hérité de ConfigurationElement)
Properties	Obtient la collection de propriétés. (Hérité de ConfigurationElement)
Redirect	Obtient ou définit l’URL de redirection.
StatusCode	Obtient ou définit le code d’état d’erreur HTTP.

Méthodes

Nom	Description
DeserializeElement(XmlReader, Boolean)	Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement)
Equals(Object)	Compare les CustomError erreurs.
GetHashCode()	Obtient le code de hachage d’objet CustomError .
GetTransformedAssemblyString(String)	Retourne la version transformée du nom d’assembly spécifié. (Hérité de ConfigurationElement)
GetTransformedTypeString(String)	Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Init()	Définit l’objet ConfigurationElement à son état initial. (Hérité de ConfigurationElement)
InitializeDefault()	Permet d’initialiser un jeu de valeurs par défaut pour l’objet ConfigurationElement. (Hérité de ConfigurationElement)
IsModified()	Indique si cet élément de configuration a été modifié depuis son dernier enregistrement ou chargement, lorsqu’il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement)
IsReadOnly()	Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement)
ListErrors(IList)	Ajoute les erreurs de propriété non valides dans cet objet ConfigurationElement et, dans tous les sous-éléments, à la liste passée. (Hérité de ConfigurationElement)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtient une valeur indiquant si un attribut inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtient une valeur indiquant si un élément inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Lève une exception lorsqu’une propriété requise est introuvable. (Hérité de ConfigurationElement)
PostDeserialize()	Appelé après la désérialisation. (Hérité de ConfigurationElement)
PreSerialize(XmlWriter)	Appelé avant la sérialisation. (Hérité de ConfigurationElement)
Reset(ConfigurationElement)	Réinitialise l’état interne de l’objet ConfigurationElement , y compris les verrous et les collections de propriétés. (Hérité de ConfigurationElement)
ResetModified()	Réinitialise la valeur de la IsModified() méthode false lorsqu’elle est implémentée dans une classe dérivée. (Hérité de ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Écrit le contenu de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Écrit les balises externes de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Définit une propriété sur la valeur spécifiée. (Hérité de ConfigurationElement)
SetReadOnly()	Définit la IsReadOnly() propriété de l’objet ConfigurationElement et de tous les sous-éléments. (Hérité de ConfigurationElement)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifie l’objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement)

Voir aussi

• CustomErrorsSection
• CustomErrorCollection