Classe HttpErrorElement

Configura la risposta a un errore HTTP specifico.

Sintassi

class HttpErrorElement : CollectionElement  

Metodi

Questa classe non contiene metodi.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla HttpErrorElement classe .

Nome	Descrizione
Path	Valore di lettura/scrittura string obbligatorio che contiene il nome o l'URL del file che viene servito in risposta all'errore HTTP specificato dalle StatusCode proprietà e SubStatusCode .
PrefixLanguageFilePath	Valore facoltativo di lettura/scrittura string che specifica il percorso fisico di una directory di una pagina di errore personalizzata. La directory della pagina di errore personalizzata contiene una o più sottodirectory specifiche della lingua con pagine di errore personalizzate per l'errore StatusCode specificato nella proprietà. Il percorso del file viene costruito come segue: PrefixLanguageFilePath\ClientLanguageID\CustomErrorPageFile. Ad esempio, PrefixLanguageFilePath potrebbe essere "%SystemDrive%\inetpub\custerr", ClientLanguageID potrebbe essere "en-us" e CustomErrorPageFile (specificato dalla Path proprietà) potrebbe essere "401.htm". Nota: Gli errori personalizzati sono specifici del linguaggio e in genere restituiscono l'errore personalizzato nella lingua di sistema del client. Per restituire una pagina di errore in una lingua diversa dalla lingua di sistema del client, il Language Pack per tale lingua deve essere installato nel client. Ad esempio, se PrefixLanguageFilePath è "d:\inetpub\custerr" e il client ha installato il Language Pack en-US, il percorso risultante per il codice di errore 404 è d:\inetpub\custerr\en-us\404.htm quando il browser client invia "en-us" nell'intestazione Accept-Language . Tuttavia, se ja-JP è la lingua di sistema e il Language Pack en-US non è installato, il percorso risultante è d:\inetpub\custerr\ja-jp\404.htm.
ResponseMode	Valore di lettura/scrittura sint32 obbligatorio che specifica la risposta all'errore HTTP specificato da StatusCode e SubStatusCode. I valori possibili sono elencati più avanti nella sezione Osservazioni.
StatusCode	Valore univoco di lettura/scrittura uint32 obbligatorio contenente un codice di stato compreso tra 400 e 999. Proprietà chiave.
SubStatusCode	Valore univoco di lettura/scrittura sint32 obbligatorio che contiene un codice substatus da -1 a 999. Il valore predefinito è –1. Proprietà chiave.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Le istanze di questa classe sono contenute nella HttpErrors proprietà array della classe HttpErrorsSection .

Questa classe rappresenta un <error> elemento nella <httpErrors> sezione del file di ApplicationHost.config.

La tabella seguente contiene i valori e le parole chiave possibili per la ResponseMode proprietà. Il valore predefinito è 0 (File).

Valore	Parola chiave	Descrizione
0	File	Il server Web restituisce la pagina Web specificata nella Path proprietà .
1	ExecuteURL	Il server Web restituisce la pagina ASP specificata in Path.
2	Redirect	Il server Web reindirizza la richiesta all'URL specificato in Path.

Gerarchia di ereditarietà

CollectionElement

HttpErrorElement

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF	WebAdministration.mof

Vedere anche

Classe CollectionElement
Classe HttpErrorsSection
Configurazione di messaggi di errore personalizzati
Codici di stato IIS