CustomErrorsSection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Configura os ASP.NET erros personalizados. Essa classe não pode ser herdada.
public ref class CustomErrorsSection sealed : System::Configuration::ConfigurationSectionpublic sealed class CustomErrorsSection : System.Configuration.ConfigurationSectiontype CustomErrorsSection = class
inherit ConfigurationSectionPublic NotInheritable Class CustomErrorsSection
Inherits ConfigurationSection- Herança
Exemplos
Este exemplo demonstra como especificar valores declarativamente para vários atributos da seção customErrors , que também podem ser acessados como membros da CustomErrorsSection classe.
O exemplo de arquivo de configuração a seguir mostra como especificar valores declarativamente para a customErrors seção.
<customErrors mode="RemoteOnly"
defaultRedirect="customerror.htm">
<error statusCode="404" redirect="customerror404.htm"/>
</customErrors>
O exemplo a seguir mostra como usar a classe CustomErrorsSection.
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest");
// Get the section.
CustomErrorsSection customErrorsSection =
(CustomErrorsSection)configuration.GetSection(
"system.web/customErrors");
// Get the collection
CustomErrorCollection customErrorsCollection =
customErrorsSection.Errors;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the section.
Dim customErrorsSection _
As CustomErrorsSection = _
CType(configuration.GetSection( _
"system.web/customErrors"), _
CustomErrorsSection)
' Get the collection
Dim customErrorsCollection _
As CustomErrorCollection = customErrorsSection.Errors
Comentários
A CustomErrorsSection classe fornece uma maneira de acessar e modificar programaticamente a customErrors seção de um arquivo de configuração. Esse tipo faz parte de um grupo que inclui o CustomErrorCollection, CustomErrorsModee CustomError tipos.
Note
CustomErrorsSection pode ler e gravar informações de e para a seção relacionada do arquivo de configuração de acordo com a propriedade AllowDefinition da seção cujo valor é Everywhere.
Construtores
| Nome | Description |
|---|---|
| CustomErrorsSection() |
Inicializa uma nova instância da classe CustomErrorsSection usando configurações padrão. |
Propriedades
| Nome | Description |
|---|---|
| AllowNestedErrors |
Obtém ou define um valor que indica se ASP.NET deve exibir uma mensagem de erro genérica quando a página de erro personalizada não pode ser exibida. |
| CurrentConfiguration |
Obtém uma referência à instância de nível Configuration superior que representa a hierarquia de configuração à qual a instância atual ConfigurationElement pertence. (Herdado de ConfigurationElement) |
| DefaultRedirect |
Obtém ou define a URL padrão para redirecionamento. |
| ElementInformation |
Obtém um ElementInformation objeto que contém as informações e funcionalidades não personalizáveis do ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| ElementProperty |
Obtém o ConfigurationElementProperty objeto que representa o ConfigurationElement objeto em si. (Herdado de ConfigurationElement) |
| Errors |
Obtém a coleção dos CustomError objetos. |
| EvaluationContext |
Obtém o objeto ContextInformation para o objeto ConfigurationElement. (Herdado de ConfigurationElement) |
| HasContext |
Obtém um valor que indica se a CurrentConfiguration propriedade é |
| Item[ConfigurationProperty] |
Obtém ou define uma propriedade ou atributo desse elemento de configuração. (Herdado de ConfigurationElement) |
| Item[String] |
Obtém ou define uma propriedade, um atributo ou um elemento filho desse elemento de configuração. (Herdado de ConfigurationElement) |
| LockAllAttributesExcept |
Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement) |
| LockAllElementsExcept |
Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement) |
| LockAttributes |
Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement) |
| LockElements |
Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement) |
| LockItem |
Obtém ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement) |
| Mode |
Obtém ou define a modalidade de exibição de erro. |
| Properties |
Obtém a coleção de propriedades. (Herdado de ConfigurationElement) |
| RedirectMode |
Obtém ou define um valor que indica se a URL da solicitação deve ser alterada quando o usuário é redirecionado para uma página de erro personalizada. |
| SectionInformation |
Obtém um SectionInformation objeto que contém as informações e a funcionalidade não personalizáveis do ConfigurationSection objeto. (Herdado de ConfigurationSection) |
Métodos
| Nome | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Lê XML do arquivo de configuração. (Herdado de ConfigurationElement) |
| DeserializeSection(XmlReader) |
Lê XML do arquivo de configuração. (Herdado de ConfigurationSection) |
| Equals(Object) |
Compara a instância atual ConfigurationElement com o objeto especificado. (Herdado de ConfigurationElement) |
| GetHashCode() |
Obtém um valor exclusivo que representa a instância atual ConfigurationElement . (Herdado de ConfigurationElement) |
| GetRuntimeObject() |
Retorna um objeto personalizado quando substituído em uma classe derivada. (Herdado de ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Retorna a versão transformada do nome do assembly especificado. (Herdado de ConfigurationElement) |
| GetTransformedTypeString(String) |
Retorna a versão transformada do nome de tipo especificado. (Herdado de ConfigurationElement) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| Init() |
Define o ConfigurationElement objeto como seu estado inicial. (Herdado de ConfigurationElement) |
| InitializeDefault() |
Usado para inicializar um conjunto padrão de valores para o ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| IsModified() |
Indica se esse elemento de configuração foi modificado desde que foi salvo ou carregado pela última vez quando implementado em uma classe derivada. (Herdado de ConfigurationSection) |
| IsReadOnly() |
Obtém um valor que indica se o ConfigurationElement objeto é somente leitura. (Herdado de ConfigurationElement) |
| ListErrors(IList) |
Adiciona os erros de propriedade inválido nesse ConfigurationElement objeto e, em todos os subelementos, à lista passada. (Herdado de ConfigurationElement) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtém um valor que indica se um atributo desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtém um valor que indica se um elemento desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Gera uma exceção quando uma propriedade necessária não é encontrada. (Herdado de ConfigurationElement) |
| PostDeserialize() |
Chamado após a desserialização. (Herdado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Chamado antes da serialização. (Herdado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Redefine o estado interno do ConfigurationElement objeto, incluindo os bloqueios e as coleções de propriedades. (Herdado de ConfigurationElement) |
| ResetModified() |
Redefine o valor do IsModified() método para |
| SerializeElement(XmlWriter, Boolean) |
Grava o conteúdo desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Cria uma cadeia de caracteres XML que contém uma exibição não mesclada do ConfigurationSection objeto como uma única seção para gravar em um arquivo. (Herdado de ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Grava as marcas externas desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Define uma propriedade como o valor especificado. (Herdado de ConfigurationElement) |
| SetReadOnly() |
Define a IsReadOnly() propriedade para o ConfigurationElement objeto e todos os subelementos. (Herdado de ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Indica se o elemento especificado deve ser serializado quando a hierarquia de objetos de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Indica se a propriedade especificada deve ser serializada quando a hierarquia de objetos de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Indica se a instância ConfigurationSection atual deve ser serializada quando a hierarquia de objetos de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica o ConfigurationElement objeto para remover todos os valores que não devem ser salvos. (Herdado de ConfigurationElement) |