Elemento customErrors (schema delle impostazioni ASP.NET)
Aggiornamento: novembre 2007
Fornisce informazioni sui messaggi di errore personalizzati di un'applicazione ASP.NET. L'elemento customErrors può essere definito a qualsiasi livello della gerarchia di file dell'applicazione.
Elemento <Configuration>
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento <customErrors>
<customErrors defaultRedirect="url"
mode="On|Off|RemoteOnly">
<error. . ./>
</customErrors>
Attributi ed elementi
Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.
Attributi
Attributo |
Descrizione |
||||||||
|---|---|---|---|---|---|---|---|---|---|
defaultRedirect |
Attributo facoltativo. Specifica l'URL predefinito a cui viene indirizzato un browser se si verifica un errore. Se non si specifica questo attributo, viene invece visualizzato un errore generico. L'URL può essere assoluto (ad esempio www.contoso.com/ErrorPage.htm) o relativo. Un URL relativo, quale /ErrorPage.htm, è relativo al file Web.config in cui è specificato l'URL per questo attributo, non alla pagina Web in cui si è verificato l'errore. Un URL che inizia con un carattere tilde (~), ad esempio ~/ErrorPage.htm, indica che l'URL specificato è relativo al percorso principale dell'applicazione. |
||||||||
mode |
Attributo obbligatorio. Specifica se gli errori personalizzati sono attivati, disattivati o visualizzati solo sui client remoti. Questo attributo può essere uno dei valori riportati di seguito.
Il valore predefinito è RemoteOnly. |
Elementi figlio
Elemento |
Descrizione |
|---|---|
error |
Elemento facoltativo. Specifica la pagina degli errori personalizzati per un codice di stato HTTP specifico. Il tag error può essere visualizzato più volte. Ogni visualizzazione definisce una condizione di errore personalizzata. |
Elementi padre
Elemento |
Descrizione |
|---|---|
configuration |
Specifica l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework. |
system.web |
Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione e contiene gli elementi che consentono di configurare le applicazioni Web ASP.NET e di controllarne il comportamento. |
Note
L'elemento <customErrors> non è valido per gli errori che si verificano nei servizi Web XML.
Configurazione predefinita
Nel file Machine.config in .NET Framework versioni 1.0 e 1.1 viene configurato l'elemento customErrors predefinito riportato di seguito.
<customErrors mode="RemoteOnly" />
Esempio
Nell'esempio di configurazione che segue viene illustrato come specificare le pagine di gestione degli errori da utilizzare per un'applicazione ASP.NET.
<configuration>
<system.web>
<customErrors defaultRedirect="GenericError.htm"
mode="RemoteOnly">
<error statusCode="500"
redirect="InternalError.htm"/>
</customErrors>
</system.web>
</configuration>
Informazioni sull'elemento
Gestore della sezione di configurazione |
|
Membro di configurazione |
|
Percorsi configurabili |
Machine.config Web.config a livello di radice Web.config a livello di applicazione Web.config a livello di directory fisica o virtuale |
Requisiti |
Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 1.0, 1.1 o 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005 |
Vedere anche
Attività
Procedura: bloccare le impostazioni di configurazione di ASP.NET
Concetti
Cenni preliminari sulla configurazione di ASP.NET
Controlli server Web ASP.NET e funzionalità del browser
Protezione della configurazione di ASP.NET
Scenari di configurazione ASP.NET
Riferimenti
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento configuration (schema delle impostazioni generali)
Elemento error per customErrors (schema delle impostazioni ASP.NET)
Altre risorse
File di configurazione ASP.NET
Impostazioni di configurazione di ASP.NET