TraceListener Kelas

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

netstandard.dll, System.Diagnostics.TraceSource.dll

Sumber:

TraceListener.cs

abstract Menyediakan kelas dasar untuk pendengar yang memantau jejak dan output debug.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable

public abstract class TraceListener : MarshalByRefObject, IDisposable

type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable

Warisan

Object

MarshalByRefObject

TraceListener

Turunan

Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

System.Web.IisTraceListener

System.Web.WebPageTraceListener

Penerapan

IDisposable

Keterangan

Untuk contoh cara mengimplementasikan TraceListener, lihat DefaultTraceListener, TextWriterTraceListener dan EventLogTraceListener kelas.

Anda harus mengaktifkan pelacakan atau penelusuran kesalahan untuk menggunakan pendengar jejak. Sintaks berikut adalah kompilator spesifik. Jika Anda menggunakan pengkompilasi selain C# atau Visual Basic, lihat dokumentasi untuk pengkompilasi Anda.

• Untuk mengaktifkan penelusuran kesalahan di C#, tambahkan /d:DEBUG bendera ke baris perintah pengkompilasi saat Mengkompilasi kode, atau Anda dapat menambahkan #define DEBUG ke bagian atas file Anda. Di Visual Basic, tambahkan /d:DEBUG=True bendera ke baris perintah pengkompilasi.

• Untuk mengaktifkan pelacakan di C#, tambahkan /d:TRACE bendera ke baris perintah pengkompilasi saat Anda mengkompilasi kode Anda, atau tambahkan #define TRACE ke bagian atas file Anda. Di Visual Basic, tambahkan /d:TRACE=True bendera ke baris perintah pengkompilasi.

Untuk menambahkan pendengar jejak, edit file konfigurasi yang sesuai dengan nama aplikasi Anda. Dalam file ini, Anda dapat menambahkan pendengar, mengatur jenisnya dan mengatur parameternya, menghapus pendengar, atau menghapus semua pendengar yang sebelumnya ditetapkan oleh aplikasi. File konfigurasi harus diformat mirip dengan contoh berikut.

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

Untuk informasi selengkapnya tentang menggunakan file konfigurasi untuk pelacakan, lihat <system.diagnostics>.

Catatan Bagi Implementer

Warisi dari kelas ini untuk mengimplementasikan pendengar kustom untuk Debug kelas dan Trace . Minimal, Anda harus menerapkan Write(String) metode dan WriteLine(String) . Selain itu, Anda dapat menerapkan Fail(String)metode , Close() dan Flush() .

Konstruktor

Nama	Deskripsi
TraceListener()	Menginisialisasi instans baru dari kelas TraceListener.
TraceListener(String)	Menginisialisasi instans TraceListener baru kelas menggunakan nama yang ditentukan sebagai pendengar.

Properti

Nama	Deskripsi
Attributes	Mendapatkan atribut listener pelacakan kustom yang ditentukan dalam file konfigurasi aplikasi.
Filter	Mendapatkan atau mengatur filter pelacakan untuk pendengar jejak.
IndentLevel	Mendapatkan atau mengatur tingkat inden.
IndentSize	Mendapatkan atau mengatur jumlah spasi dalam inden.
IsThreadSafe	Mendapatkan nilai yang menunjukkan apakah pendengar pelacakan aman.
Name	Mendapatkan atau menetapkan nama untuk ini TraceListener.
NeedIndent	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan mengindentasi output.
TraceOutputOptions	Mendapatkan atau mengatur opsi output jejak.

Metode

Nama	Deskripsi
Close()	Saat ditimpa di kelas turunan, menutup aliran output sehingga tidak lagi menerima output pelacakan atau penelusuran kesalahan.
Dispose()	Merilis semua sumber daya yang digunakan oleh TraceListener.
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang TraceListener digunakan oleh dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Fail(String, String)	Memancarkan pesan kesalahan dan pesan kesalahan terperinci ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
Fail(String)	Memancarkan pesan kesalahan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
Flush()	Ketika ditimpa di kelas turunan, siram buffer output.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetSupportedAttributes()	Mendapatkan atribut kustom yang didukung oleh pendengar jejak.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Menulis informasi pelacakan, objek data, dan informasi peristiwa ke output spesifik pendengar.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Menulis informasi pelacakan, array objek data, dan informasi peristiwa ke output spesifik pendengar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Menulis informasi pelacakan, array objek dan informasi peristiwa yang diformat ke output spesifik pendengar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Menulis informasi pelacakan, pesan, dan informasi peristiwa ke output spesifik pendengar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Menulis jejak dan informasi peristiwa ke output spesifik pendengar.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Menulis informasi pelacakan, pesan, identitas aktivitas terkait, dan informasi peristiwa ke output spesifik pendengar.
Write(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
Write(Object)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
Write(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
Write(String)	Saat ditimpa di kelas turunan, menulis pesan yang ditentukan ke pendengar yang Anda buat di kelas turunan.
WriteIndent()	Menulis inden ke pendengar yang Anda buat saat mengimplementasikan kelas ini, dan mengatur ulang NeedIndent properti ke false.
WriteLine(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti oleh terminator baris.
WriteLine(Object)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti oleh terminator baris.
WriteLine(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti oleh terminator baris.
WriteLine(String)	Saat ditimpa di kelas turunan, menulis pesan kepada pendengar yang Anda buat di kelas turunan, diikuti oleh terminator baris.

Keamanan Thread

Jenis ini aman untuk utas.

Lihat juga

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <Elemen system.diagnostics>