CustomErrorsSection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Configura gli errori personalizzati ASP.NET. La classe non può essere ereditata.
public ref class CustomErrorsSection sealed : System::Configuration::ConfigurationSectionpublic sealed class CustomErrorsSection : System.Configuration.ConfigurationSectiontype CustomErrorsSection = class
inherit ConfigurationSectionPublic NotInheritable Class CustomErrorsSection
Inherits ConfigurationSection- Ereditarietà
Esempio
In questo esempio viene illustrato come specificare i valori in modo dichiarativo per diversi attributi della sezione customErrors , a cui è possibile accedere anche come membri della CustomErrorsSection classe .
Nell'esempio di file di configurazione seguente viene illustrato come specificare i valori in modo dichiarativo per la customErrors sezione .
<customErrors mode="RemoteOnly"
defaultRedirect="customerror.htm">
<error statusCode="404" redirect="customerror404.htm"/>
</customErrors>
Nell'esempio seguente viene illustrato come utilizzare la 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
Commenti
La CustomErrorsSection classe consente di accedere e modificare a livello di codice la customErrors sezione di un file di configurazione. Questo tipo fa parte di un gruppo che include i CustomErrorCollectiontipi , CustomErrorsModee CustomError .
Note
CustomErrorsSection può leggere e scrivere informazioni da e alla sezione correlata del file di configurazione in base alla proprietà AllowDefinition della sezione il cui valore è Everywhere.
Costruttori
| Nome | Descrizione |
|---|---|
| CustomErrorsSection() |
Inizializza una nuova istanza della classe CustomErrorsSection utilizzando le impostazioni predefinite. |
Proprietà
| Nome | Descrizione |
|---|---|
| AllowNestedErrors |
Ottiene o imposta un valore che indica se ASP.NET deve visualizzare un messaggio di errore generico quando non è possibile visualizzare la pagina di errore personalizzata. |
| CurrentConfiguration |
Ottiene un riferimento all'istanza di Configuration di primo livello che rappresenta la gerarchia di configurazione a cui appartiene l'istanza di ConfigurationElement corrente. (Ereditato da ConfigurationElement) |
| DefaultRedirect |
Ottiene o imposta l'URL predefinito per il reindirizzamento. |
| ElementInformation |
Ottiene un oggetto ElementInformation che contiene le informazioni e le funzionalità non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| ElementProperty |
Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement) |
| Errors |
Ottiene l'insieme degli CustomError oggetti . |
| EvaluationContext |
Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| HasContext |
Ottiene un valore che indica se la proprietà CurrentConfiguration è |
| Item[ConfigurationProperty] |
Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement) |
| Item[String] |
Ottiene o imposta una proprietà, un attributo o un elemento figlio di questo elemento di configurazione. (Ereditato da ConfigurationElement) |
| LockAllAttributesExcept |
Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement) |
| LockAllElementsExcept |
Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement) |
| LockAttributes |
Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement) |
| LockElements |
Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement) |
| LockItem |
Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement) |
| Mode |
Ottiene o imposta la modalità di visualizzazione degli errori. |
| Properties |
Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement) |
| RedirectMode |
Ottiene o imposta un valore che indica se l'URL della richiesta deve essere modificato quando l'utente viene reindirizzato a una pagina di errore personalizzata. |
| SectionInformation |
Ottiene un SectionInformation oggetto che contiene le informazioni e le funzionalità non personalizzabili dell'oggetto ConfigurationSection . (Ereditato da ConfigurationSection) |
Metodi
| Nome | Descrizione |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement) |
| DeserializeSection(XmlReader) |
Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationSection) |
| Equals(Object) |
Confronta l'istanza corrente ConfigurationElement con l'oggetto specificato. (Ereditato da ConfigurationElement) |
| GetHashCode() |
Ottiene un valore univoco che rappresenta l'istanza corrente ConfigurationElement . (Ereditato da ConfigurationElement) |
| GetRuntimeObject() |
Restituisce un oggetto personalizzato quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Restituisce la versione trasformata del nome dell'assembly specificato. (Ereditato da ConfigurationElement) |
| GetTransformedTypeString(String) |
Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| Init() |
Imposta l'oggetto ConfigurationElement sullo stato iniziale. (Ereditato da ConfigurationElement) |
| InitializeDefault() |
Utilizzato per inizializzare un set predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| IsModified() |
Indica se questo elemento di configurazione è stato modificato dopo l'ultimo salvataggio o caricamento quando implementato in una classe derivata. (Ereditato da ConfigurationSection) |
| IsReadOnly() |
Ottiene un valore che indica se l'oggetto ConfigurationElement è di sola lettura. (Ereditato da ConfigurationElement) |
| ListErrors(IList) |
Aggiunge gli errori di proprietà non validi in questo oggetto ConfigurationElement e in tutti i sottoelementi all'elenco passato. (Ereditato da ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Ottiene un valore che indica se viene rilevato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Ottiene un valore che indica se durante la deserializzazione viene rilevato un elemento sconosciuto. (Ereditato da ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Genera un'eccezione quando non viene trovata una proprietà obbligatoria. (Ereditato da ConfigurationElement) |
| PostDeserialize() |
Chiamato dopo la deserializzazione. (Ereditato da ConfigurationElement) |
| PreSerialize(XmlWriter) |
Chiamato prima della serializzazione. (Ereditato da ConfigurationElement) |
| Reset(ConfigurationElement) |
Reimposta lo stato interno dell'oggetto ConfigurationElement , inclusi i blocchi e gli insiemi di proprietà. (Ereditato da ConfigurationElement) |
| ResetModified() |
Reimposta il valore del IsModified() metodo su |
| SerializeElement(XmlWriter, Boolean) |
Scrive il contenuto di questo elemento di configurazione nel file di configurazione quando implementato in una classe derivata. (Ereditato da ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Crea una stringa XML contenente una visualizzazione non archiviata dell'oggetto ConfigurationSection come singola sezione da scrivere in un file. (Ereditato da ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Scrive i tag esterni di questo elemento di configurazione nel file di configurazione quando implementato in una classe derivata. (Ereditato da ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement) |
| SetReadOnly() |
Imposta la IsReadOnly() proprietà per l'oggetto ConfigurationElement e tutti i sottoelementi. (Ereditato da ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Indica se l'elemento specificato deve essere serializzato quando la gerarchia degli oggetti di configurazione viene serializzata per la versione di destinazione specificata di .NET Framework. (Ereditato da ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Indica se la proprietà specificata deve essere serializzata quando la gerarchia degli oggetti di configurazione viene serializzata per la versione di destinazione specificata di .NET Framework. (Ereditato da ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Indica se l'istanza corrente di ConfigurationSection deve essere serializzata quando la gerarchia degli oggetti di configurazione viene serializzata per la versione di destinazione specificata di .NET Framework. (Ereditato da ConfigurationSection) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica l'oggetto ConfigurationElement per rimuovere tutti i valori che non devono essere salvati. (Ereditato da ConfigurationElement) |