Elemento <customErrors>

Articolo
04/11/2008

Fornisce informazioni sui messaggi di errore personalizzati di un'applicazione ASP.NET.

<configuration>
<system.web>
<customErrors>

<customErrorsdefaultRedirect="url"              mode="On|Off|RemoteOnly">   <error statusCode="statuscode"          redirect="url"/></customErrors>

Attributo obbligatorio

Attributo	Opzione	Descrizione
Mode		Specifica se gli errori personalizzati sono attivati, disattivati o visualizzati solo sui client remoti.
	On	Specifica che gli errori personalizzati sono attivati. Se non si specifica alcun attributo defaultRedirect, viene visualizzato un errore generico.
	Off	Specifica che gli errori personalizzati sono disattivati. Questo consente la visualizzazione di errori dettagliati.
	RemoteOnly	Specifica che gli errori personalizzati vengono visualizzati solo sui client remoti mentre gli errori ASP.NET vengono visualizzati sull'host locale. Rappresenta l'impostazione predefinita.

Attributo facoltativo

Attributo	Descrizione
defaultRedirect	Specifica l'URL predefinito a cui viene indirizzato un browser se si verifica un errore. Se non si specifica alcun attributo defaultRedirect, viene visualizzato un errore generico. L'URL può essere assoluto, ad esempio https://www.contoso.com/ErrorPage.htm, oppure relativo. Un URL relativo quale /ErrorPage.htm è relativo al file Web.config in cui è specificato l'URL defaultRedirect e 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.

defaultRedirect

Specifica l'URL predefinito a cui viene indirizzato un browser se si verifica un errore. Se non si specifica alcun attributo defaultRedirect, viene visualizzato un errore generico. L'URL può essere assoluto, ad esempio https://www.contoso.com/ErrorPage.htm, oppure relativo. Un URL relativo quale /ErrorPage.htm è relativo al file Web.config in cui è specificato l'URL defaultRedirect e 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.

Sottotag

Sottotag	Descrizione
<error>	Il sottotag error può essere visualizzato più volte. Ogni visualizzazione definisce una condizione di errore personalizzata.

Osservazioni

L'elemento <customErrors> non è valido per gli errori che si verificano nei servizi Web XML.

Esempio

Nell'esempio che segue vengono specificate 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>

Requisiti

Contenuto in: <system.web>

Piattaforma Web: IIS 5.0, IIS 5.1, IIS 6.0

File di configurazione: Machine.config, Web.config

Gestore della sezione di configurazione: System.Web.Configuration.CustomErrorsConfigHandler

Vedere anche

Configurazione ASP.NET | Schema delle impostazioni ASP.NET

Condividi tramite