TraceListener Kelas

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

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 spesifik pengkompilasi. 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, 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 listener, mengatur jenisnya dan mengatur parameternya, menghapus listener, atau menghapus semua listener 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

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

Properti

Attributes	Mendapatkan atribut pendengar 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 jejak aman untuk utas.
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

Close()	Saat ditimpa di kelas turunan, menutup aliran output sehingga tidak lagi menerima output pelacakan atau penelusuran kesalahan.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang TraceListenerdigunakan oleh .
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh TraceListener dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Fail(String)	Memancarkan pesan kesalahan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
Fail(String, String)	Memancarkan pesan kesalahan dan pesan kesalahan terperinci ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
Flush()	Saat ditimpa di kelas turunan, hapus 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 pelacakan.
GetType()	Mendapatkan dari instans Type 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 saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (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)	Menulis jejak dan informasi peristiwa 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, String, Object[])	Menulis informasi pelacakan, array objek dan informasi peristiwa yang diformat 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)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas .
Write(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
Write(String)	Saat ditimpa di kelas turunan, tulis pesan yang ditentukan ke pendengar yang Anda buat di kelas turunan.
Write(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas.
WriteIndent()	Menulis inden ke pendengar yang Anda buat saat mengimplementasikan kelas ini, dan mengatur ulang NeedIndent properti ke false.
WriteLine(Object)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris.
WriteLine(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris.
WriteLine(String)	Saat ditimpa di kelas turunan, menulis pesan ke pendengar yang Anda buat di kelas turunan, diikuti dengan terminator baris.
WriteLine(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris.

Keamanan Thread

Jenis ini aman untuk utas.

Lihat juga

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <System.diagnostics> Element