CustomErrorCollection.Clear Metode

Definisi

Ruang nama:

System.Web.Configuration

Rakitan:

System.Web.dll

Menghapus semua CustomError objek dari koleksi.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Contoh

Contoh kode berikut menghapus semua CustomError objek dari CustomErrorCollection koleksi. Lihat contoh kode di CustomErrorCollection topik kelas untuk mempelajari cara mendapatkan koleksi.

// 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

Keterangan

Hasil pembaruan file konfigurasi setelah memanggil Clear metode tergantung pada yang ConfigurationSaveMode dipilih. Untuk memperbarui file konfigurasi, Anda menggunakan salah satu dari dua kelebihan beban ini: Save dan Save.

Catatan

Panggilan Save setara dengan panggilan Save.

Jika Anda menggunakan Save.method, kondisi berikut berlaku.

• Jika Anda meneruskan Full nilai parameter atau Modified , maka clear elemen disisipkan ke bagian clientTarget file konfigurasi pada tingkat hierarki saat ini.

• Jika Anda meneruskan Minimal nilai parameter, serangkaian remove elemen ditambahkan ke clientTarget Element (ASP.NET Settings Schema) dari file konfigurasi pada tingkat hierarki saat ini. Masing-masing menghapus semua referensi ke elemen yang add ditentukan dalam file konfigurasi induk pada tingkat yang lebih tinggi dalam hierarki. Saat Anda menggunakan Minimal, ada satu properti tambahan pada koleksi yang memengaruhi apa yang diserialisasikan ke file konfigurasi: EmitClear, yang secara false default. Ketentuan berikut berlaku.

  • EmitClear Jika diatur ke true, clear elemen disisipkan ke bagian clientTarget file konfigurasi pada tingkat hierarki saat ini. Ini menghapus semua referensi ke elemen yang add ditentukan dalam file konfigurasi induk pada tingkat yang lebih tinggi dalam hierarki.

  • EmitClear Jika bendera diatur ke false, clear elemen dihapus dari bagian clientTarget file konfigurasi pada tingkat hierarki saat ini, jika ada.

Metode ini Clear benar-benar menghapus elemen yang add ditentukan di bagian clientTarget file konfigurasi pada tingkat hierarki saat ini. Ini juga menghapus semua referensi ke tambahkan elemen yang ditentukan dalam file konfigurasi induk pada tingkat yang lebih tinggi dalam hierarki.

Catatan

Elemen add tidak dihapus dari bagian clientTarget file konfigurasi induk.