customErrors elementu (ASP.Schemat ustawień netto)

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Zawiera informacje o niestandardowych komunikatach o błędach dla aplikacji ASP.NET aplikacji. customErrors Elementu mogą być definiowane na dowolnym poziomie w hierarchii pliku aplikacji.

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.

Atrybuty

Atrybut	Opis
defaultRedirect	Atrybut opcjonalny. Określa domyślny adres URL będzie przekierowywana przeglądarka, jeśli wystąpi błąd. Gdy ten atrybut nie jest określony, zamiast tego wyświetlany jest błąd rodzajowy. Adres URL może być bezwzględny (na przykład, www.contoso.com/ErrorPage.htm) lub względna. Względny adres URL, takie jak /ErrorPage.htm, jest względna w pliku Web.config, który określony adres URL dla tego atrybutu, a nie strony sieci Web, w którym wystąpił błąd. Adres URL, zaczynając od znaku tyldy (~), takie jak ~/ErrorPage.htm, wskazuje, że określony adres URL jest adekwatny do ścieżki katalogu głównego aplikacji.
mode	Wymagany atrybut. Określa, czy błędów niestandardowych są włączone, wyłączone lub pokazano tylko do klientów zdalnych. Ten atrybut może być jedną z następujących wartości. WartośćOpis On Określa, że błędy niestandardowe są włączone.Jeśli nie defaultRedirect atrybut jest określony, użytkownicy widzą błąd rodzajowy.Błędy niestandardowe są wyświetlane do klientów zdalnych oraz do hosta lokalnego. Off Określa, że błędy niestandardowe są wyłączone.Szczegółowe ASP.NET błędy są oznaczone do klientów zdalnych oraz do hosta lokalnego. RemoteOnly Określa, że błędy niestandardowe są wyświetlane tylko do klientów zdalnych i program ASP.NET będą wyświetlane na hoście lokalnym.Jest to wartość domyślna. Wartością domyślną jest RemoteOnly.
redirectMode	Atrybut opcjonalny. Określa sposób obsługi adres URL pierwotnego żądania, po wyświetleniu strony błędu niestandardowego wartości. Ten atrybut może być jedną z następujących wartości. WartośćOpis ResponseRedirect Określa, że adres URL do przeglądarki do kierowania musi się różnić od oryginalnego adresu URL żądania sieci Web. ResponseRewrite Określa, że adres URL do przeglądarki do kierowania musi być oryginalny adres URL żądania sieci Web.

Elementy podrzędne

Element	Opis
error	Opcjonalnego elementu. Określa stronę błędu niestandardowego dla danego kodu stanu HTTP. Tag błąd może wystąpić wiele razy. Każde wystąpienie określa jeden warunek błędu niestandardowego.

Elementy nadrzędne

Element	Opis
configuration	Określa element główny w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.NET Framework aplikacji.
system.web	Określa element główny dla aplikacji ASP.Ustawienia konfiguracji netto w konfiguracji pliku i zawiera elementy konfiguracyjne określające konfigurację programu ASP.NET aplikacje sieci Web i kontrolować zachowanie tych aplikacji.

Uwagi

Domyślna konfiguracja

Następujące domyślne customErrors element jest skonfigurowany w pliku Machine.config w.NET Framework w wersji 1.0 i 1.1.

<customErrors mode="RemoteOnly" />

Przykład

Poniższy przykład konfiguracji demonstruje, jak określić strony, aby użyć dla aplikacji ASP obsługi błędów.NET aplikacji.

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

Informacje o elementach

Program obsługi sekcji konfiguracji	System.Web.Configuration.CustomErrorsSection
Członkowskie konfiguracji	SystemWebSectionGroup.CustomErrors System.Web.Configuration.CustomErrorsMode
Lokalizacje konfigurowalne	Machine.config Web.config na poziomie katalogu głównego Poziom aplikacji Web.config Directory–level wirtualnego lub fizycznego Web.config
Wymagania	Microsoft Internet Information Services (IIS) w wersji 5.0, 5.1 lub 6.0 .NET Framework w wersji 1.0, 1.1 lub 2.0 Microsoft Visual Studio 2003 lub Visual Studio 2005

Zobacz też

Zadania

How to: Lock ASP.NET Configuration Settings

Informacje

System.Web elementu (ASP.Schemat ustawień netto)

Konfiguracja elementu (schemat ustawień ogólne)

Błąd Element customErrors (ASP.Schemat ustawień netto)

System.Configuration

System.Web.Configuration

Koncepcje

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Inne zasoby

ASP.NET Configuration Files

ASP.NET ustawienia konfiguracji

Ogólne ustawienia konfiguracji (ASP.(NET)

ASP.NET Configuration API