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 CustomErrorCustomErrorCollection tüm nesneleri kaldırır. Koleksiyonu nasıl edineceğinizi öğrenmek için sınıf konusunun kod örneğine CustomErrorCollection 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.

Note

Çağrı Save, Save çağrısıyla eş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 clear geçerli hiyerarşi düzeyindeki bölümüne bir clientTarget öğe eklenir.

• Minimal parametre değerini geçirirseniz, geçerli hiyerarşi düzeyinde yapılandırma dosyasının remove bir dizi öğesi eklenir. Her öğe, hiyerarşide daha yüksek bir add düzeyde üst yapılandırma dosyasında tanımlanan bir öğeye yapılan tüm başvuruları 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 olan false . Aşağıdaki koşullar geçerlidir.

  • EmitClear olarak ayarlanırsatrueclear, öğesi geçerli hiyerarşi düzeyinde yapılandırma dosyasının bölümüne eklenirclientTarget. 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 clientTarget kaldırılır.

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

Note

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