Elemen <penambahan> dari <pendengar> untuk <pelacakan>

  • Artikel

Menghapus koleksi Listeners untuk lacak.

<konfigurasi>
  <system.diagnostics>
    <jejak>
      <pendengar>
        <bersihkan>

Sintaks

<clear/>

Atribut dan Elemen

Bagian berikut menjelaskan atribut, elemen turunan, dan elemen induk.

Atribut

Tidak ada.

Elemen Anak

Tidak ada.

Elemen Induk

Elemen Deskripsi
configuration Elemen akar di setiap file konfigurasi yang digunakan oleh runtime bahasa umum dan aplikasi .NET Framework.
system.diagnostics Menentukan melacak pendengar yang mengumpulkan, menyimpan, dan merutekan pesan dan tingkat di mana sakelar jejak diatur.
trace Berisi pendengar yang mengumpulkan, menyimpan, dan melacak rute pesan.
listeners Berisi pendengar yang mengumpulkan, menyimpan, dan merutekan pesan. Pendengar mengarahkan hasil penelusuran ke target yang sesuai.

Keterangan

Elemen <clear> menghapus semua pendengar dari Listeners koleksi untuk pelacakan. Anda bisa menggunakan elemen <clear> sebelum menggunakan elemen <add> untuk memastikan tidak ada pendengar aktif lainnya dalam koleksi.

Anda bisa menghapus Listeners koleksi secara terprogram dengan memanggil Clear metode pada Trace.Listeners properti (System.Diagnostics.Trace.Listeners.Clear()).

Elemen ini bisa digunakan dalam file konfigurasi mesin (Machine.config) dan file konfigurasi aplikasi.

Catatan

Elemen <clear> menghapus DefaultTraceListener dari koleksi Listeners, mengubah perilaku metode Debug.Assert, Trace.Assert, Debug.Fail, dan Trace.Fail. Memanggil Assert metode atau Fail biasanya menghasilkan tampilan kotak pesan. Namun, kotak pesan tidak ditampilkan jika DefaultTraceListener tidak ada dalam Listeners koleksi.

Contoh

Contoh berikut menunjukkan cara menggunakan <clear> elemen sebelum menggunakan <add> elemen untuk menambahkan pendengar console ke Listeners koleksi untuk pelacakan.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <clear/>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Lihat juga