Classe CustomError

Articolo
07/19/2023

Specifica un ASP.NET messaggio di errore personalizzato per un errore del codice di stato HTTP.

Sintassi

class CustomError : CollectionElement

Metodi

Questa classe non contiene metodi.

Proprietà

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

Nome	Descrizione
`Redirect`	Valore di lettura/scrittura `string` non valido obbligatorio che contiene il percorso di un file o di un URL che contiene un messaggio di errore personalizzato.
`StatusCode`	Valore di lettura/scrittura `sint32` univoco obbligatorio che specifica un codice di stato di errore HTTP. I valori validi sono compresi tra 100 e 999. Proprietà chiave.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Le istanze di questa classe sono contenute nella CustomErrors proprietà della classe CustomErrorsSection .

Gli errori personalizzati rappresentati dalla CustomError classe sono specifici di ASP.NET e si trovano nella <system.web> sezione del file Web.config. Gli errori personalizzati rappresentati dalla classe HttpErrorElement sono specifici di IIS 7 e si trovano nella <system.webServer> sezione del file ApplicationHost.config.

Esempio

Nell'esempio seguente viene aggiunto un errore personalizzato alla sezione errori personalizzati del sito Web predefinito.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the CustomError class object.  
Set oCustomError = oWebAdmin.Get("CustomError")  
  
' Create a new instance of the CustomError class.  
Set oNewCustomError = oCustomError.SpawnInstance_  
  
' Assign values to the StatusCode and Redirect properties.  
oNewCustomError.StatusCode = 404  
oNewCustomError.Redirect ="CustomPageNotFoundError.htm"  
  
' Get the custom errors section for the default Web site.   
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CustomErrorsSection", oCustomErrorsSection  
  
' Call the CustomErrorsSection.Add method to add the custom error.  
oCustomErrorsSection.Add "CustomErrors", oNewCustomError

Gerarchia di ereditarietà

CollectionElement

CustomError

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 CustomErrorsSection
Classe HttpErrorElement
Classe HttpErrorsSection

Condividi tramite