Elemento error per customErrors (schema delle impostazioni ASP.NET)

  • Articolo

Aggiornamento: novembre 2007

Specifica la pagina degli errori personalizzati per un codice di stato HTTP specifico.

Elemento <Configuration>
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento customErrors (schema delle impostazioni ASP.NET)
      Elemento error per customErrors (schema delle impostazioni ASP.NET)

<error statusCode="statuscode"
       redirect="url"/>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo

Descrizione

statusCode

Attributo obbligatorio.

Specifica il codice di stato HTTP in base al quale si verrà reindirizzati alla pagina di errore.

redirect

Attributo obbligatorio.

URL della pagina personalizzata mappata al codice di errore.

Elementi figlio

Nessuno.

Elementi padre

Elemento

Descrizione

configuration

Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento di primo livello per la sezione di configurazione ASP.NET.

customErrors

Fornisce informazioni sui messaggi di errore personalizzati di un'applicazione ASP.NET. Può essere definito a qualsiasi livello della gerarchia di file dell'applicazione.

Esempio

Nell'esempio di codice di configurazione riportato di seguito vengono specificate le pagine di gestione degli errori da utilizzare per un'applicazione ASP.NET.

Gli errori personalizzati vengono generati solo per gli elementi gestiti da ASP.NET. Se, ad esempio, si fa riferimento a una pagina htm non esistente, da Microsoft Internet Information Services (IIS) viene generato l'errore standard 404. Se invece si fa riferimento a una pagina aspx non esistente, da ASP.NET verrà generato l'errore 404 personalizzato, se configurato.

<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

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

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 customErrors (schema delle impostazioni ASP.NET)

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

System.Configuration

System.Web.Configuration

Altre risorse

File di configurazione ASP.NET

Impostazioni di configurazione di ASP.NET

Impostazioni di configurazione generali (ASP.NET)

API di configurazione di ASP.NET