CustomErrorCollection.Clear Yöntem

Tanım

Ad Alanı:

System.Web.Configuration

Bütünleştirilmiş Kod:

System.Web.dll

Koleksiyondaki tüm CustomError nesneleri kaldırır.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Örnekler

Aşağıdaki kod örneği, koleksiyondaki CustomError tüm nesneleri CustomErrorCollection kaldırır. Koleksiyonu nasıl edineceğinizi öğrenmek için sınıf konusunun CustomErrorCollection kod örneğine bakın.

// Using the Clear method.
if (!customErrorsSection.SectionInformation.IsLocked)
{
    // Execute the Clear method.
    customErrorsCollection.Clear();
    configuration.Save();
}

' Using the Clear method.
If Not customErrorsSection.SectionInformation.IsLocked Then
   ' Execute the Clear method.
   customErrorsCollection.Clear()
   configuration.Save()
End If

Açıklamalar

yöntemi çağrıldıktan sonra yapılandırma dosyasını güncelleştirmenin Clear sonucu seçilene ConfigurationSaveMode bağlıdır. Yapılandırma dosyasını güncelleştirmek için şu iki aşırı yüklemeden birini kullanırsınız: Save ve Save.

Not

Çağrısı Save , çağrısıyla Saveeşdeğerdir.

.method kullanırsanız Save, aşağıdaki koşullar geçerlidir.

• Bir Full veya Modified parametre değeri geçirirseniz, yapılandırma dosyasının clientTarget geçerli hiyerarşi düzeyindeki bölümüne bir clear öğe eklenir.

• Parametre değerini geçirirseniz Minimal , yapılandırma dosyasının removeclientTarget Öğesine (ASP.NET Ayarlar Şeması) geçerli hiyerarşi düzeyinde bir dizi öğe eklenir. Her biri, hiyerarşide daha yüksek bir düzeyde üst yapılandırma dosyasında tanımlanan bir öğeye yapılan tüm başvuruları add kaldırır. kullandığınızda Minimal, koleksiyonda yapılandırma dosyasında seri hale getirilenleri etkileyen bir özellik daha vardır: EmitClearvarsayılan olarak budur false . Aşağıdaki koşullar geçerlidir.

  • EmitClear olarak ayarlanırsatrue, clear öğesi yapılandırma dosyasının clientTarget geçerli hiyerarşi düzeyindeki bölümüne eklenir. Bu, hiyerarşideki add daha yüksek düzeylerde üst yapılandırma dosyalarında tanımlanan öğelere yapılan tüm başvuruları kaldırır.

  • EmitClear bayrağı olarak ayarlanırsafalseclear, öğe varsa geçerli hiyerarşi düzeyinde yapılandırma dosyasının bölümünden kaldırılırclientTarget.

Clear yöntemi aslında yapılandırma dosyasının add bölümünde tanımlanan clientTarget öğeleri geçerli hiyerarşi düzeyinde siler. Ayrıca hiyerarşideki üst yapılandırma dosyalarında tanımlanan ekleme öğelerine yapılan tüm başvuruları kaldırır.

Not

Öğeler add üst yapılandırma dosyalarının clientTarget bölümünden silinmez.