Elemento customErrors (schema delle impostazioni ASP.NET)

Articolo
05/27/2012

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

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.

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli 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 radice dell'applicazione.
mode	Attributo obbligatorio. Specifica se gli errori personalizzati sono attivati, disabilitati o visualizzati solo sui client remoti. Questo attributo può essere uno dei valori riportati di seguito. ValoreDescrizione On Specifica che gli errori personalizzati sono attivati.Se non si specifica alcun attributo defaultRedirect, viene visualizzato un errore generico.Gli errori personalizzati vengono visualizzati sui client remoti e sull'host locale. Off Specifica che gli errori personalizzati sono disabilitati.Gli errori ASP.NET dettagliati vengono visualizzati sui client remoti e sull'host locale. RemoteOnly Specifica che gli errori personalizzati vengono visualizzati solo sui client remoti, mentre gli errori ASP.NET vengono visualizzati sull'host locale.Rappresenta il valore predefinito. Il valore predefinito è RemoteOnly.
redirectMode	Attributo facoltativo. Specifica i valori relativi al modo in cui viene gestito l'URL della richiesta originale quando viene visualizzata una pagina di errore personalizzata. Questo attributo può essere uno dei valori riportati di seguito. ValoreDescrizione ResponseRedirect Specifica che l'URL a cui indirizzare il browser deve essere diverso dall'URL della richiesta Web originale. ResponseRewrite Specifica che l'URL a cui indirizzare il browser deve essere l'URL della richiesta Web originale.

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 radice dell'applicazione.

mode

Attributo obbligatorio.

Specifica se gli errori personalizzati sono attivati, disabilitati o visualizzati solo sui client remoti.

Questo attributo può essere uno dei valori riportati di seguito.

ValoreDescrizione

On Specifica che gli errori personalizzati sono attivati.Se non si specifica alcun attributo defaultRedirect, viene visualizzato un errore generico.Gli errori personalizzati vengono visualizzati sui client remoti e sull'host locale.

Off Specifica che gli errori personalizzati sono disabilitati.Gli errori ASP.NET dettagliati vengono visualizzati sui client remoti e sull'host locale.

RemoteOnly Specifica che gli errori personalizzati vengono visualizzati solo sui client remoti, mentre gli errori ASP.NET vengono visualizzati sull'host locale.Rappresenta il valore predefinito.

Il valore predefinito è RemoteOnly.

redirectMode

Attributo facoltativo.

Specifica i valori relativi al modo in cui viene gestito l'URL della richiesta originale quando viene visualizzata una pagina di errore personalizzata.

Questo attributo può essere uno dei valori riportati di seguito.

ValoreDescrizione

ResponseRedirect Specifica che l'URL a cui indirizzare il browser deve essere diverso dall'URL della richiesta Web originale.

ResponseRewrite Specifica che l'URL a cui indirizzare il browser deve essere l'URL della richiesta Web originale.

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.

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

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	System.Web.Configuration.CustomErrorsSection
Membro di configurazione	SystemWebSectionGroup.CustomErrors System.Web.Configuration.CustomErrorsMode
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

Elemento customErrors (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive