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

Artikel
04/08/2023

Menambahkan pendengar ke koleksi Pendengar.

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

Sintaks

<add name="name"
     type="trace listener class name, Version, Culture, PublicKeyToken"  
     initializeData="data"/>

Atribut dan Elemen

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

Atribut

Atribut	Deskripsi
jenis	Atribut yang diperlukan. Menentukan jenis pendengar. Anda harus menggunakan string yang memenuhi persyaratan yang ditentukan dalam Menentukan Nama Jenis yang Sepenuhnya Memenuhi Syarat.
initializeData	Atribut opsional. String diteruskan ke konstruktor untuk kelas yang ditentukan.
nama	Atribut opsional. Menentukan nama pendengar.

Elemen Anak

Elemen	Deskripsi
<filter>	Menambahkan filter ke pendengar dalam koleksi `Listeners` untuk pelacakan.

Elemen Induk

Elemen	Deskripsi
`configuration`	Elemen akar di setiap file konfigurasi yang digunakan oleh runtime dan aplikasi .NET Framework.
`listeners`	Menentukan listener yang mengumpulkan, menyimpan, dan merutekan pesan. Pendengar mengarahkan output pelacakan ke target yang sesuai.
`system.diagnostics`	Menentukan elemen akar untuk bagian konfigurasi ASP.NET.
`trace`	Berisi pendengar yang mengumpulkan, menyimpan, dan merutekan pesan pelacakan.

Keterangan

Kelas Debug dan Trace berbagi koleksi Pendengar yang sama. Jika Anda menambahkan objek pendengar ke koleksi di salah satu kelas ini, kelas lain menggunakan pendengar yang sama. Kelas pendengar berasal dari TraceListener.

Jika Anda tidak menentukan atribut name dari pendengar pelacakan, Name dari pendengar pelacakan default ke string kosong (""). Jika aplikasi Anda hanya memiliki satu pendengar, Anda dapat menambahkannya tanpa menentukan nama, dan menghapusnya dengan menentukan string kosong untuk nama tersebut. Namun, jika aplikasi Anda memiliki lebih dari satu pendengar, Anda harus menentukan nama unik untuk setiap pendengar pelacakan, yang memungkinkan Anda mengidentifikasi dan mengelola pendengar pelacakan individual dalam koleksi Listeners dan Listeners.

Catatan

Menambahkan lebih dari satu pendengar jejak dari jenis yang sama dan dengan nama yang sama hanya menghasilkan satu pendengar jejak dari jenis dan nama tersebut yang ditambahkan ke koleksi Listeners. Namun, Anda dapat menambahkan beberapa pendengar identik secara terprogram ke koleksi Listeners.

Nilai untuk atribut initializeData bergantung pada jenis pendengar yang Anda buat. Tidak semua pendengar jejak mengharuskan Anda menentukan initializeData.

Catatan

Saat Anda menggunakan atribut initializeData, Anda mungkin mendapatkan peringatan kompiler "Atribut 'initializeData' tidak dideklarasikan." Peringatan ini terjadi karena pengaturan konfigurasi divalidasi terhadap kelas dasar abstrak TraceListener, yang tidak mengenali atribut initializeData. Biasanya, Anda dapat mengabaikan peringatan ini untuk melacak implementasi pendengar yang memiliki konstruktor yang mengambil parameter.

Tabel berikut menunjukkan pendengar jejak yang disertakan dengan .NET Framework dan menjelaskan nilai atribut initializeData mereka.

Lacak kelas pendengar	inisialisasi Nilai atributData
System.Diagnostics.ConsoleTraceListener	Nilai `useErrorStream` untuk konstruktor ConsoleTraceListener. Atur atribut `initializeData` ke "`true`" untuk menulis pelacakan dan hasil debug ke Console.Error; "`false`" untuk menulis ke Console.Out.
System.Diagnostics.DelimitedListTraceListener	Nama file tujuan penulisan DelimitedListTraceListener.
System.Diagnostics.EventLogTraceListener	Nama dari nama sumber log peristiwa yang ada.
System.Diagnostics.EventSchemaTraceListener	Nama file tujuan penulisan EventSchemaTraceListener.
System.Diagnostics.TextWriterTraceListener	Nama file tujuan penulisan TextWriterTraceListener.
System.Diagnostics.XmlWriterTraceListener	Nama file tujuan penulisan XmlWriterTraceListener.

Contoh

Contoh berikut menunjukkan cara menggunakan elemen <tambahkan> untuk menambahkan listener MyListener dan MyEventListener ke koleksi Pendengar. MyListener membuat file bernama MyListener.log dan menulis output ke file. MyEventListener membuat entri di log peristiwa.

<configuration>  
   <system.diagnostics>  
      <trace autoflush="true" indentsize="0">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
            <add name="MyEventListener"  
                 type="System.Diagnostics.EventLogTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"                 initializeData="MyConfigEventLog"/>  
            <add name="configConsoleListener"  
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Bagikan melalui