Bagikan melalui

Cara: Membuat dan Menginisialisasi Pendengar Jejak

  • Artikel

Catatan

Artikel ini khusus untuk .NET Framework. Ini tidak berlaku untuk implementasi .NET yang lebih baru, termasuk .NET 6 dan versi yang lebih baru.

Kelas System.Diagnostics.Debug dan System.Diagnostics.Trace mengirim pesan ke objek yang disebut pendengar yang menerima dan memproses pesan-pesan ini. Salah satu pendengar tersebut, System.Diagnostics.DefaultTraceListener, secara otomatis dibuat dan diinisialisasi saat pelacakan diaktifkan. Jika Anda ingin output Trace atau Debug diarahkan ke sumber tambahan apa pun, Anda harus membuat dan menginisialisasi pendengar jejak tambahan.

Pendengar yang Anda buat harus mencerminkan kebutuhan aplikasi Anda. Misalnya, jika Anda menginginkan rekaman teks dari semua output jejak, buat pendengar TextWriterTraceListener, yang menulis semua output ke file teks baru saat diaktifkan. Di sisi lain, jika Anda ingin melihat output hanya selama eksekusi aplikasi, buat pendengar ConsoleTraceListener, yang mengarahkan semua output ke jendela konsol. EventLogTraceListener dapat mengarahkan output jejak ke log peristiwa. Untuk informasi selengkapnya, lihat Lacak Pendengar .

Anda dapat membuat pendengar jejak dalam file konfigurasi aplikasi atau dalam kode Anda. Kami merekomendasikan penggunaan file konfigurasi aplikasi, karena memungkinkan Anda menambahkan, memodifikasi, atau menghapus pendengar jejak tanpa harus mengubah kode Anda.

Untuk membuat dan menggunakan pendengar pelacakan dengan menggunakan file konfigurasi

  1. Nyatakan pendengar jejak Anda dalam file konfigurasi aplikasi Anda. Jika pendengar yang Anda buat memerlukan objek lain, nyatakan juga hal tersebut. Contoh berikut menunjukkan cara membuat pendengar yang disebut myListener yang menulis ke file teks TextWriterOutput.log.

    <configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

  2. Gunakan kelas Trace dalam kode Anda untuk menulis pesan ke pendengar jejak.

    Trace.TraceInformation("Test message.")
' You must close or flush the trace to empty the output buffer.
Trace.Flush()

    Trace.TraceInformation("Test message.");
// You must close or flush the trace to empty the output buffer.
Trace.Flush();

Untuk membuat dan menggunakan pendengar jejak dalam kode

  • Tambahkan pendengar jejak ke koleksi Listeners dan kirim informasi pelacakan ke pendengar.

    Trace.Listeners.Add(New TextWriterTraceListener("TextWriterOutput.log", "myListener"))
Trace.TraceInformation("Test message.")
' You must close or flush the trace to empty the output buffer.
Trace.Flush()

    Trace.Listeners.Add(new TextWriterTraceListener("TextWriterOutput.log", "myListener"));
Trace.TraceInformation("Test message.");
// You must close or flush the trace to empty the output buffer.
Trace.Flush();

    - atau -

  • Jika Anda tidak ingin pendengar Anda menerima output jejak, jangan tambahkan hal tersebut ke koleksi Listeners. Anda dapat memancarkan output melalui pendengar yang independen dari koleksi Listeners dengan memanggil metode output listener sendiri. Contoh berikut menunjukkan cara menulis baris ke pendengar yang tidak ada dalam koleksi Listeners.

    Dim myListener As New TextWriterTraceListener("TextWriterOutput.log", "myListener")
myListener.WriteLine("Test message.")
' You must close or flush the trace listener to empty the output buffer.
myListener.Flush()

    TextWriterTraceListener myListener = new TextWriterTraceListener("TextWriterOutput.log", "myListener");
myListener.WriteLine("Test message.");
// You must close or flush the trace listener to empty the output buffer.
myListener.Flush();

Lihat juga