Classe CustomErrorsSection
Configura ASP.NET messaggi di errore personalizzati.
Sintassi
class CustomErrorsSection : ConfigurationSectionWithCollection
Metodi
Nella tabella seguente sono elencati i metodi esposti dalla CustomErrorsSection classe .
| Nome | Descrizione |
|---|---|
| Aggiungere | Ereditato da ConfigurationSectionWithCollection. |
| Cancella | Ereditato da ConfigurationSectionWithCollection. |
| Recupero | Ereditato da ConfigurationSectionWithCollection. |
| GetAllowDefinition | Ereditato da ConfigurationSection. |
| GetAllowLocation | Ereditato da ConfigurationSection. |
| Rimuovi | Ereditato da ConfigurationSectionWithCollection. |
| RevertToParent | Ereditato da ConfigurationSection. |
| SetAllowDefinition | Ereditato da ConfigurationSection. |
| SetAllowLocation | Ereditato da ConfigurationSection. |
Proprietà
Nella tabella seguente sono elencate le proprietà esposte dalla CustomErrorsSection classe .
| Nome | Descrizione |
|---|---|
CustomErrors |
Matrice di valori CustomError che specificano errori personalizzati ASP.NET. |
DefaultRedirect |
Valore di lettura/scrittura string obbligatorio che contiene il percorso predefinito di un file di messaggio di errore HTTP o l'URL di un messaggio di errore. Questo valore viene ereditato dalla Redirect proprietà degli oggetti CustomError appena creati. |
Location |
Ereditato da ConfigurationSection.) Proprietà chiave. |
Mode |
Enumerazione di lettura/scrittura sint32 che specifica se le pagine di errore personalizzate o predefinite vengono visualizzate in locale o in remoto. I valori possibili sono elencati più avanti nella sezione Osservazioni. |
Path |
Ereditato da ConfigurationSection.) Proprietà chiave. |
SectionInformation |
Ereditato da ConfigurationSection. |
Sottoclassi
Questa classe non contiene sottoclassi.
Commenti
Gli errori personalizzati rappresentati dalla CustomErrorsSection classe sono specifici di ASP.NET e si trovano nella <system.web> sezione del file Web.config. Ognuno di questi errori è rappresentato da un'istanza della classe CustomError .
Gli errori personalizzati rappresentati dalla classe HttpErrorsSection sono correlati a IIS 7 e si trovano nella <system.webServer> sezione del file ApplicationHost.config. Ognuno di questi errori è rappresentato da un'istanza della classe HttpErrorElement . L'integrazione di ASP.NET con IIS in IIS 7 ha apportato questa modifica al nome necessaria.
Nella tabella seguente sono elencati i valori possibili per la Mode proprietà. Il valore predefinito è 0 (RemoteOnly).
| Valore | Parola chiave | Descrizione |
|---|---|---|
| 0 | RemoteOnly |
La pagina di errore predefinita ASP.NET viene visualizzata agli utenti locali. Gli utenti remoti riceveranno una pagina di errore personalizzata se ne viene definita una. Se non viene definita alcuna pagina di errore personalizzata per l'errore ricevuto, viene visualizzata una pagina di errore IIS. |
| 1 | On |
Viene visualizzata una pagina di errore personalizzata definita dall'utente ASP.NET per gli utenti locali e remoti. |
| 2 | Off |
La pagina di errore predefinita ASP.NET viene visualizzata per gli utenti locali e remoti. |
Esempio
Nell'esempio seguente la DefaultRedirect proprietà viene impostata su "CustomError.htm" e sulla Mode proprietà su On.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the custom errors section for the default Web site.
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")
oSite.GetSection "CustomErrorsSection", oSection
' Set the default redirect page to CustomError.htm,
' and set the Mode property to On.
oSection.DefaultRedirect = "CustomError.htm"
oSection.Mode = 1
oSection.Put_
Gerarchia di ereditarietà
ConfigurationSectionWithCollection
CustomErrorsSection
Requisiti
| Tipo | Descrizione |
|---|---|
| Client | - IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10 |
| Server | - IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016 |
| Prodotto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| File MOF | WebAdministration.mof |
Vedere anche
Classe ConfigurationSectionWithCollection
Classe CustomError
Classe HttpErrorElement
Classe HttpErrorsSection