CustomError Sınıf

Tanım

Ad Alanı:

System.Web.Configuration

Bütünleştirilmiş Kod:

System.Web.dll

ASP.NET hata kodunu özel bir sayfaya eşlemek için bir CustomError bölümü yapılandırılır. Bu sınıf devralınamaz.

public ref class CustomError sealed : System::Configuration::ConfigurationElement

public sealed class CustomError : System.Configuration.ConfigurationElement

type CustomError = class
    inherit ConfigurationElement

Public NotInheritable Class CustomError
Inherits ConfigurationElement

Devralma

Object

ConfigurationElement

CustomError

Örnekler

Bu örnek, sınıfın üyeleri olarak da erişilebilen bölümün customErrors çeşitli öznitelikleri için değerleri bildirimli olarak belirtmeyi CustomError gösterir.

Aşağıdaki yapılandırma dosyası örneği, bölümü için değerleri bildirimli olarak belirtmeyi customErrors gösterir.

<customErrors mode="RemoteOnly"
  defaultRedirect="customerror.htm">
    <error statusCode="404" redirect="customerror404.htm"/>
</customErrors>

Aşağıdaki kod örneğinde sınıfın nasıl kullanılacağı gösterilmektedir CustomError .

// Get the Web application configuration.
Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnetTest");

// Get the section.
CustomErrorsSection customErrors =
    (CustomErrorsSection)configuration.GetSection(
  "system.web/customErrors");

// Get the collection.
CustomErrorCollection customErrorsCollection =
    customErrors.Errors;

' Get the Web application configuration.
  Dim configuration _
  As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnetTest")

' Get the section.
  Dim customErrors As CustomErrorsSection = _
   CType(configuration.GetSection( _
   "system.web/customErrors"), CustomErrorsSection)

' Get the collection.
  Dim customErrorsCollection _
  As CustomErrorCollection = _
  customErrors.Errors

Açıklamalar

sınıfı, CustomError bir yapılandırma dosyasının bölümüne program aracılığıyla erişmek ve bunları değiştirmek error için bir yol sağlar. Bu tür, , CustomErrorCollectionve CustomErrorsModeiçeren CustomErrorsSectionbir grubun parçasıdır.

Note

Özel bir hata tanımladığınızda, ASP.NET iis gibi temel alınan hizmet tarafından normalde verilen standart hatayı atar. Örneğin, 404 durum kodu için özel bir hata tanımlarsanız, ASP.NET var olmayan bir .aspx sayfasına başvurdığınızda bu hatayı gönderir. Özel hatalar yalnızca ASP.NET tarafından işlenen öğeler için verilir. Örneğin, var olmayan bir .htm sayfasına başvurursanız, IIS standart 404 hatasını gönderir.

Oluşturucular

Name	Description
CustomError(Int32, String)	CustomError sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
CurrentConfiguration	Geçerli Configuration örneğin ait olduğu yapılandırma hiyerarşisini temsil eden en üst düzey ConfigurationElement örneğe başvuru alır. (Devralındığı yer: ConfigurationElement)
ElementInformation	Özelleştirilebilir olmayan bilgileri ve nesnenin işlevselliğini ElementInformation içeren bir ConfigurationElement nesne alır. (Devralındığı yer: ConfigurationElement)
ElementProperty	Nesnenin ConfigurationElementProperty kendisini temsil ConfigurationElement eden nesneyi alır. (Devralındığı yer: ConfigurationElement)
EvaluationContext	ContextInformation nesnesi için ConfigurationElement nesnesini alır. (Devralındığı yer: ConfigurationElement)
HasContext	özelliğinin CurrentConfigurationolup olmadığını null gösteren bir değer alır. (Devralındığı yer: ConfigurationElement)
Item[ConfigurationProperty]	Bu yapılandırma öğesinin özelliğini veya özniteliğini alır veya ayarlar. (Devralındığı yer: ConfigurationElement)
Item[String]	Bu yapılandırma öğesinin bir özelliğini, özniteliğini veya alt öğesini alır veya ayarlar. (Devralındığı yer: ConfigurationElement)
LockAllAttributesExcept	Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockAllElementsExcept	Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockAttributes	Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockElements	Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockItem	Öğesinin kilitli olup olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: ConfigurationElement)
Properties	Özellik koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
Redirect	Yeniden yönlendirme URL'sini alır veya ayarlar.
StatusCode	HTTP hata durum kodunu alır veya ayarlar.

Yöntemler

Name	Description
DeserializeElement(XmlReader, Boolean)	Yapılandırma dosyasından XML okur. (Devralındığı yer: ConfigurationElement)
Equals(Object)	Hataları karşılaştırır CustomError .
GetHashCode()	Nesne karması CustomError kodunu alır.
GetTransformedAssemblyString(String)	Belirtilen derleme adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement)
GetTransformedTypeString(String)	Belirtilen tür adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Init()	ConfigurationElement Nesneyi ilk durumuna ayarlar. (Devralındığı yer: ConfigurationElement)
InitializeDefault()	Nesne için varsayılan değer kümesini başlatmak için ConfigurationElement kullanılır. (Devralındığı yer: ConfigurationElement)
IsModified()	Bu yapılandırma öğesinin türetilmiş bir sınıfta uygulandığında son kaydedildiğinden veya yüklendiğinden beri değiştirilip değiştirilmediğini gösterir. (Devralındığı yer: ConfigurationElement)
IsReadOnly()	Nesnenin ConfigurationElement salt okunur olup olmadığını gösteren bir değer alır. (Devralındığı yer: ConfigurationElement)
ListErrors(IList)	Bu ConfigurationElement nesnedeki ve tüm alt öğelerdeki invalid-property hatalarını geçirilen listeye ekler. (Devralındığı yer: ConfigurationElement)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDeserializeUnrecognizedAttribute(String, String)	Seri durumdan çıkarma sırasında bilinmeyen bir öznitelikle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Seri durumdan çıkarma sırasında bilinmeyen bir öğeyle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement)
OnRequiredPropertyNotFound(String)	Gerekli bir özellik bulunamadığında bir özel durum oluşturur. (Devralındığı yer: ConfigurationElement)
PostDeserialize()	Seri durumdan çıkarıldıktan sonra çağrılır. (Devralındığı yer: ConfigurationElement)
PreSerialize(XmlWriter)	Serileştirmeden önce çağrılır. (Devralındığı yer: ConfigurationElement)
Reset(ConfigurationElement)	Kilitler ve özellik koleksiyonları dahil olmak üzere nesnenin iç durumunu ConfigurationElement sıfırlar. (Devralındığı yer: ConfigurationElement)
ResetModified()	Türetilmiş bir sınıfta uygulandığında yönteminin IsModified()false değerini olarak sıfırlar. (Devralındığı yer: ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Türetilmiş bir sınıfta uygulandığında bu yapılandırma öğesinin içeriğini yapılandırma dosyasına yazar. (Devralındığı yer: ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Türetilmiş bir sınıfta uygulandığında bu yapılandırma öğesinin dış etiketlerini yapılandırma dosyasına yazar. (Devralındığı yer: ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Bir özelliği belirtilen değere ayarlar. (Devralındığı yer: ConfigurationElement)
SetReadOnly()	IsReadOnly() Nesnenin ve tüm alt öğelerinin ConfigurationElement özelliğini ayarlar. (Devralındığı yer: ConfigurationElement)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	ConfigurationElement Kaydedilmemesi gereken tüm değerleri kaldırmak için nesnesini değiştirir. (Devralındığı yer: ConfigurationElement)

Ayrıca bkz.

• CustomErrorsSection
• CustomErrorCollection