customErrors Ögesi (ASP.NET Ayarlar Şeması)

  • Makale

Bir ASP.NET uygulamasında kullanılan özel hata iletileriyle ilgili bilgi içerir. customErrors ögesi uygulama dosyası hiyerarşisindeki herhangi bir düzeyde tanımlanabilir.

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

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik

Açıklama

defaultRedirect

İsteğe bağlı öznitelik.

Bir hata ortaya çıktığında tarayıcının yönlendirileceği varsayılan URL'i belirtir. Bu öznitelik belirtilmemişse, yerine genel bir hata görüntülenir.

URL mutlak (örneğin, www.contoso.com/ErrorPage.htm) veya göreli olabilir. /ErrorPage.htm gibi göreli bir URL, hatanın ortaya çıktığı Web sayfasına göre değil, bu öznitelik için URL belirten Web.config dosyasına göre belirlenir. ~/ErrorPage.htm gibi, bir URL'in tilde (~) simgesiyle başlaması belirtilen URL'in uygulamanın kök yolu ile ilgili olduğu anlamına gelir.

mode

Gerekli öznitelik.

Özel hataların etkinleştirilmiş, devre dışı veya yalnızca uzaktaki istemcilere görüntülenebilir durumda olduğunu belirtir.

Bu öznitelik aşağıdaki değerlerden biri olabilir.

ValueAçıklama
On Özel hataların etkin olduğunu belirtir.Hiç defaultRedirect özniteliği belirtilmezse, kullanıcılar genel hata iletisi görür.Özel hatalar uzak istemcilerde ve yerel ana bilgisayarda görüntülenir.
Off Özel hataların devre dışı bırakıldığını belirtir.Ayrıntılı ASP.NET hataları uzak istemcilerde ve yerel ana bilgisayarda görüntülenir.
RemoteOnly Özel hataların yalnızca uzaktaki istemcilere görüntüleneceğini, ASP.NET hatalarının ise yerel ana bilgisayarda görüntüleneceğini belirtir.Bu, varsayılan değerdir.

Varsayılan, RemoteOnly değeridir.

redirectMode

İsteğe bağlı öznitelik.

Özel hata sayfası görüntülendiğinde, özgün isteğin URL'si nasıl işlendiğini için değerleri belirtir.

Bu öznitelik aşağıdaki değerlerden biri olabilir.

ValueAçyklama
ResponseRedirect Tarayıcının yönlendirileceği URL'yi özgün Web isteği URL'den farklı olması gerektiğini belirtir.
ResponseRewrite Tarayıcının yönlendirileceği URL'yi özgün Web istek URL'si olması gerektiğini belirtir.

Alt Öğeler

Öge

Açyklama

error

İsteğe bağlı öğe.

Verilen bir HTTP durum kodu için özel hata sayfasını belirtir.

Hata etiketi birden çok kez kullanılabilir. Her alt etiket bir özel hata durumunu tanımlar.

Üst Öğeler

Öge

Açıklama

configuration

Ortak dil çalıştırma modülü ile .NET Framework uygulamaları tarafından kullanılan bütün yapılandırma dosyalarında yer alması gereken kök ögeyi belirtir.

system.web

Yapılandırma dosyasında ASP.NET yapılandırma ayarları için kök öge belirtir ve ASP.NET Web uygulamalarını yapılandıran ve uygulamaların davranışını denetleyen yapılandırma ögelerini içerir.

Açıklamalar

Varsayılan Yapılandırma

.NET Framework sürüm 1.0 ve 1.1'de, aşağıdaki varsayılan customErrors ögesi Machine.config dosyası içinde yapılandırılmıştır.

<customErrors mode="RemoteOnly" />

Örnek

Aşağıdaki yapılandırma örneğinde bir ASP.NET uygulamasında kullanılacak hata işleme sayfalarının nasıl belirtildiği gösterilmektedir.

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

Öğe Bilgileri

Yapılandırma bölümü işleyicisi

System.Web.Configuration.CustomErrorsSection

Yapılandırma üyesi

SystemWebSectionGroup.CustomErrors

System.Web.Configuration.CustomErrorsMode

Yapılandırılabilir konumlar

Machine.config

Kök düzeyinde Web.config

Uygulama düzeyinde Web.config

Sanal veya fiziksel dizin düzeyinde Web.config

Gereksinimler

Microsoft Internet Information Services (IIS) sürüm 5.0, 5.1 veya 6.0

.NET Framework sürüm 1.0, 1.1 veya 2.0

Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Görevler

Nasıl Yapılır: ASP.NET Yapılandırması kilitlemek Ayarlar

Başvuru

system.web Ögesi (ASP.NET Ayarlar Şeması)

configuration Ögesi (Genel Ayarlar Şeması)

customErrors için error Ögesi (ASP.NET Ayarlar Şeması)

System.Configuration

System.Web.Configuration

Kavramlar

ASP.NET yapılandırmasına genel bakış

ASP.NET web sunucusu Denetimler ve tarayıcı yetenekleri

ASP.NET Yapılandırması güvenliğini sağlama

ASP.NET Yapılandırması senaryoları

Diğer Kaynaklar

ASP.NET Yapılandırması dosyalarının

ASP.NET Yapılandırma Ayarları

Genel Yapılandırma Ayarları (ASP.NET)

ASP.NET Yapılandırması API