Errori <HTTP httpErrors>

Panoramica

L'elemento <httpErrors> consente di configurare messaggi di errore personalizzati per il sito Web o l'applicazione. I messaggi di errore personalizzati consentono di fornire una risposta descrittiva o più informativa inviando un file, restituendo un'altra risorsa o reindirizzando l'utente a un URL quando i visitatori del sito non riescono ad accedere al contenuto richiesto. È possibile ad esempio personalizzare le pagine dei messaggi di errore del sito Web in modo da avere lo stesso aspetto del resto del sito.

L'elemento <httpErrors> contiene una raccolta di <error> elementi, ognuno dei quali definisce un messaggio di errore usato da IIS per rispondere a errori HTTP specifici. È possibile aggiungere messaggi di errore personalizzati a IIS aggiungendo un <error> elemento all'elemento nel file di Web.config per il sito, l'applicazione o l'URL <httpErrors> . Ogni <error> elemento usa l'attributo responseMode per specificare se IIS gestisce contenuto statico, contenuto dinamico o reindirizza a un URL separato in risposta a un errore.

È possibile utilizzare l'elemento <remove> per rimuovere un messaggio di errore specifico dalla raccolta di messaggi di errore ereditati dal sito o dall'applicazione da un livello superiore nella gerarchia di configurazione iis. È anche possibile usare l'elemento <clear> per rimuovere tutti i messaggi di errore HTTP dalla raccolta di messaggi di errore HTTP ereditati dal sito o dall'applicazione.

L'elemento <httpErrors> contiene anche attributi che configurano IIS 7 per elaborare le richieste che causano errori. L'attributo existingResponse definisce le operazioni che IIS 7 esegue a una risposta esistente quando il server restituisce un codice di stato di errore HTTP. L'attributo defaultPath definisce il percorso di una pagina di errore del cliente se si sceglie File per l'attributo responseMode in un <error> elemento.

L'attributo detailedMoreInformationLink specifica un collegamento a ulteriori informazioni su un errore specifico.

L'elemento <httpErrors> può anche contenere un attributo errorMode che è possibile usare per controllare il livello di dettaglio restituito da IIS a un browser quando si verifica un errore HTTP. È possibile impostare l'attributo errorMode su DetailedLocalOnly, ovvero l'impostazione predefinita oppure impostarlo su Personalizzato o Dettagliato. Se si specifica DetailedLocalOnly o se non si specifica un valore errorMode, IIS restituisce informazioni dettagliate sull'errore solo al browser nel server locale e un messaggio di errore personalizzato a un browser in un computer esterno. Se si imposta il valore errorMode su Personalizzato, IIS restituisce solo messaggi di errore personalizzati a tutti i browser che richiedono. Se si imposta il valore errorMode su Detailed, IIS restituisce informazioni dettagliate sull'errore a tutti i browser che richiedono. Il valore predefinito DetailedLocalOnly consente di risolvere gli errori HTTP nel server locale senza esporre informazioni riservate a browser esterni.

Per impostazione predefinita, IIS gestisce i messaggi di errore definiti nei file archiviati nella cartella %SystemRoot%\Help\IisHelp\Common. È possibile creare un messaggio di errore personalizzato per gli utenti e configurare IIS per restituire questa pagina ogni volta che si verifica un errore HTTP specifico nel sito.

Compatibilità

Installazione

L'elemento <httpErrors> è incluso nell'installazione predefinita di IIS 7.

Procedure

Come aggiungere una pagina di errore personalizzata

1. Aprire Gestione Internet Information Services (IIS):

   • Se si usa Windows Server 2012 o Windows Server 2012 R2:

     • Sulla barra delle applicazioni fare clic su Server Manager, scegliere Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).

   • Se si usa Windows 8 o Windows 8.1:

     • Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
     • Fare clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).

   • Se si usa Windows Server 2008 o Windows Server 2008 R2:

     • Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Gestione Internet Information Services (IIS).

   • Se si usa Windows Vista o Windows 7:

     • Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
     • Fare doppio clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).

2. Nel riquadro Connessioni espandere il nome del server, espandere Siti e quindi passare al sito Web o all'applicazione per cui si desidera configurare pagine di errore personalizzate.

3. Nel riquadro Home fare doppio clic su Pagine di errore.
   

4. Nel riquadro Azioni fare clic su Aggiungi...

5. Nella finestra di dialogo Aggiungi pagina errore personalizzata digitare il numero del codice di stato HTTP per il quale si desidera creare un messaggio di errore personalizzato.
   

6. Nella sezione Azione di risposta eseguire una delle operazioni seguenti:

   • Selezionare Inserisci contenuto dal file statico nella risposta di errore per gestire il contenuto statico, ad esempio un file di .html, per l'errore personalizzato.
   • Selezionare Execute a URL on this site (Esegui un URL in questo sito ) per gestire il contenuto dinamico, ad esempio un file asp per l'errore personalizzato.
   • Selezionare Rispondi con un reindirizzamento 302 per reindirizzare i browser client a un URL diverso che contiene il file di errore personalizzato.

7. Nella casella di testo Percorso file digitare il percorso della pagina di errore personalizzata se si sceglie Inserisci contenuto da un file statico nella risposta di errore o nell'URL della pagina di errore personalizzata se si utilizza l'opzione Esegui un URL in questo sito o Rispondi con un reindirizzamento 302 e quindi fare clic su OK.

   Nota

   Se si seleziona Esegui un URL in questo sito, il percorso deve essere un percorso relativo. Se si seleziona Rispondi con un reindirizzamento 302, l'URL deve essere un URL assoluto.

Configurazione

È possibile configurare l'elemento <httpErrors> a livello di server nel file ApplicationHost.config e a livello di sito e applicazione nel file di Web.config appropriato.

Attributi

Elementi figlio

Esempio di configurazione

Nell'esempio di configurazione seguente, se incluso nel file di Web.config per un sito Web o un'applicazione, viene utilizzato l'attributo errorMode per consentire solo la visualizzazione di messaggi di errore dettagliati nel computer locale. Usa anche l'attributo defaultResponseMode per impostare la modalità di risposta per il sito o l'applicazione. L'esempio rimuove quindi il messaggio di errore ereditato per il codice di stato 500. Imposta quindi l'attributo prefixLanguageFilePath sulla directory in cui IIS deve cercare una nuova pagina di errore personalizzata e imposta l'attributo path su 500.htm, il file che contiene il messaggio di errore personalizzato.

<configuration>
   <system.webServer>
      <httpErrors errorMode="DetailedLocalOnly" defaultResponseMode="File" >
         <remove statusCode="500" />
         <error statusCode="500"
            prefixLanguageFilePath="C:\Contoso\Content\errors"
            path="500.htm" />
       </httpErrors>
   </system.webServer>
</configuration>

Codice di esempio

Gli esempi seguenti aggiungono un nuovo file per tutti gli errori di codice di stato 404 con uno stato secondario pari a 5, che IIS restituisce per gli errori "URL Sequence Denied". In questi esempi il percorso del prefisso è impostato su "%SystemDrive%\inetpub\custerr" e il nome del file viene specificato come "404.5.htm".

AppCmd.exe

appcmd.exe set config -section:system.webServer/httpErrors /+"[statusCode='404',subStatusCode='5',prefixLanguageFilePath='%SystemDrive%\inetpub\custerr',path='404.5.htm']" /commit:apphost

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection httpErrorsSection = config.GetSection("system.webServer/httpErrors");
         ConfigurationElementCollection httpErrorsCollection = httpErrorsSection.GetCollection();

         ConfigurationElement errorElement = httpErrorsCollection.CreateElement("error");
         errorElement["statusCode"] = 404;
         errorElement["subStatusCode"] = 5;
         errorElement["prefixLanguageFilePath"] = @"%SystemDrive%\inetpub\custerr";
         errorElement["path"] = @"404.5.htm";
         httpErrorsCollection.Add(errorElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim httpErrorsSection As ConfigurationSection = config.GetSection("system.webServer/httpErrors")
      Dim httpErrorsCollection As ConfigurationElementCollection = httpErrorsSection.GetCollection

      Dim errorElement As ConfigurationElement = httpErrorsCollection.CreateElement("error")
      errorElement("statusCode") = 404
      errorElement("subStatusCode") = 5
      errorElement("prefixLanguageFilePath") = "%SystemDrive%\inetpub\custerr"
      errorElement("path") = "404.5.htm"
      httpErrorsCollection.Add(errorElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var httpErrorsSection = adminManager.GetAdminSection("system.webServer/httpErrors", "MACHINE/WEBROOT/APPHOST");
var httpErrorsCollection = httpErrorsSection.Collection;

var errorElement = httpErrorsCollection.CreateNewElement("error");
errorElement.Properties.Item("statusCode").Value = 404;
errorElement.Properties.Item("subStatusCode").Value = 5;
errorElement.Properties.Item("prefixLanguageFilePath").Value = "%SystemDrive%\\inetpub\\custerr";
errorElement.Properties.Item("path").Value = "404.5.htm";
httpErrorsCollection.AddElement(errorElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set httpErrorsSection = adminManager.GetAdminSection("system.webServer/httpErrors", "MACHINE/WEBROOT/APPHOST")
Set httpErrorsCollection = httpErrorsSection.Collection

Set errorElement = httpErrorsCollection.CreateNewElement("error")
errorElement.Properties.Item("statusCode").Value = 404
errorElement.Properties.Item("subStatusCode").Value = 5
errorElement.Properties.Item("prefixLanguageFilePath").Value = "%SystemDrive%\inetpub\custerr"
errorElement.Properties.Item("path").Value = "404.5.htm"
httpErrorsCollection.AddElement errorElement

adminManager.CommitChanges()