Element customErrors (schéma nastavení ASP.NET)

Obsahuje informace o vlastní chybové zprávě aplikaci technologie ASP.NET. Element customErrors lze definovat na libovolné úrovni v hierarchii souborů aplikace.

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
defaultRedirect	Nepovinný atribut. Určuje výchozí adresu URL, na kterou je prohlížeč přesměrován, pokud nastane chyba. Pokud není tento atribut zadán, je zobrazena obecné chyba. Adresa URL může být absolutní (například www.contoso.com/ErrorPage.htm) nebo relativní. Relativní adresa URL, jako například /ErrorPage.htm, je relativní vůči souboru Web.config, který určuje adresu URL pro tento atribut. Nikoli pro webovou stránku, ve které chyba nastala. Adresy URL začínající znakem vlnky (~), jako například ~/ErrorPage.htm, znamenají, že zadaná adresa URL je relativní ke kořenové cestě aplikace.
mode	Požadovaný atribut. Určuje, zda jsou vlastní chyby aktivní, neaktivní, nebo jsou zobrazeny pouze vzdáleným klientům. Tento atribut se může rovnat jedné z následujících hodnot. HodnotaPopis On Určuje, zda jsou povoleny vlastní chyby.Pokud není specifikován atribut defaultRedirect, je uživatelům zobrazena obecná chyba.Vlastní chyby jsou zobrazeny vzdáleným klientům a místnímu hostiteli. Off Určuje, zda jsou vlastní chyby neaktivní.Podrobné chyby technologie ASP.NET se zobrazí vzdáleným klientům a místnímu hostiteli. RemoteOnly Určuje, že vlastní chyby jsou zobrazeny pouze vzdáleným klientům a že chyby technologie ASP.NET jsou zobrazeny místnímu hostiteli.Jedná se o výchozí hodnotu. Výchozí hodnota je RemoteOnly.
redirectMode	Nepovinný atribut. Určuje způsob zpracování URL původního požadavku při zobrazení stránky vlastní chybové hodnoty. Tento atribut se může rovnat jedné z následujících hodnot. HodnotaPopis ResponseRedirect Určuje URL přímo do prohlížeče musí být odlišné od původní požadavek URL webu. ResponseRewrite Určuje URL přímo do prohlížeče na původní požadavek URL webu.

Podřízené prvky

Prvek	Popis
error	Volitelný prvek. Určuje vlastní chybovou stránku pro daný kód stavu protokolu HTTP. Značka error se může objevit vícekrát. Každý výskyt definuje jednu podmínku vlastní chyby.

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.

Poznámky

Výchozí konfigurace

Následující výchozí customErrors prvek nastaven v souboru Machine.config v.NET Framework verze 1.0 a 1.1.

<customErrors mode="RemoteOnly" />

Příklad

Následující příklad konfigurace demonstruje, jak specifikovat stránky pro zpracování chyb dané aplikace technologie ASP.NET.

<configuration>
  <system.web>
    <customErrors defaultRedirect="GenericError.htm"
                  mode="RemoteOnly">
      <error statusCode="500"
             redirect="InternalError.htm"/>
    </customErrors>
  </system.web>
</configuration>

Informace prvku

Obslužná rutina konfiguračního oddílu	System.Web.Configuration.CustomErrorsSection
Konfigurační člen	SystemWebSectionGroup.CustomErrors System.Web.Configuration.CustomErrorsMode
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework, verze 1.0, 1.1 nebo 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Úkoly

Postupy: Uzamknutí nastavení konfigurace technologie ASP.NET

Odkaz

Element system.web (schéma nastavení ASP.NET)

Element configuration (schéma obecného nastavení)

Podelement error elementu customErrors (schéma nastavení ASP.NET)

System.Configuration

System.Web.Configuration

Koncepty

Přehled konfigurace technologie ASP.NET

Ovládací prvky webového serveru technologie ASP.NET a schopnosti prohlížeče

Zabezpečení konfigurace technologie ASP.NET

Scénáře konfigurace technologie ASP.NET

Další zdroje

Konfigurační soubory technologie ASP.NET

Nastavení konfigurace ASP.NET

Obecné nastavení konfigurace (technologie ASP.NET)

Rozhraní API konfigurace technologie ASP.NET