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

Makale
08/01/2011

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.

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.

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.

Aracılığıyla paylaş

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

Öznitelikler ve Öğeler

Öznitelikler

Alt Öğeler

Üst Öğeler

Açıklamalar

Varsayılan Yapılandırma

Örnek

Öğe Bilgileri

Ayrıca bkz.

Görevler

Başvuru

Kavramlar

Diğer Kaynaklar

Ek kaynaklar