TextWriterTraceListener Kelas

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

netstandard.dll, System.Diagnostics.TextWriterTraceListener.dll

Sumber:

TextWriterTraceListener.cs

Mengarahkan output pelacakan atau penelusuran kesalahan ke TextWriter atau ke Stream, seperti FileStream.

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener

public class TextWriterTraceListener : System.Diagnostics.TraceListener

type TextWriterTraceListener = class
    inherit TraceListener

Public Class TextWriterTraceListener
Inherits TraceListener

Warisan

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

Turunan

System.Diagnostics.ConsoleTraceListener

System.Diagnostics.DelimitedListTraceListener

System.Diagnostics.EventSchemaTraceListener

System.Diagnostics.XmlWriterTraceListener

Contoh

Contoh berikut mengimplementasikan instans TextWriterTraceListener kelas yang menggunakan panggilan StreamWritermyOutputWriter untuk menulis ke file bernama TestFile.txt. Pertama, contoh membuat file untuk output. Kemudian membuat StreamWriter untuk penulis teks pertama, menetapkannya file output, dan menambahkannya ke Listeners. Kemudian, kode mengeluarkan satu baris teks ke file. Terakhir, contoh menghapus buffer output.

Setelah menjalankan sampel ini, Anda dapat membuka TestFile.txt file untuk melihat output.

public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");

    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);

    // Write output to the file.
    Trace.Write("Test output ");

    // Flush the output.
    Trace.Flush();

    return 0;
 }
}

Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Keterangan

Kelas TextWriterTraceListener menyediakan Writer properti untuk mendapatkan atau mengatur penulis teks yang menerima output pelacakan atau penelusuran kesalahan.

Important

Jenis ini mengimplementasikan antarmuka IDisposable. Setelah selesai menggunakan jenis , Anda harus membuangnya baik secara langsung (dengan memanggil metodenya Dispose ) atau secara tidak langsung (dengan konstruksi bahasa seperti using di C#). Untuk informasi selengkapnya, lihat Menggunakan objek yang mengimplementasikan IDisposable.

Kelas ini juga menyediakan metode untuk CloseWriter sehingga tidak lagi menerima output pelacakan atau penelusuran kesalahan, ke Flush buffer output untuk Writer, dan ke Write pesan ke Writer.

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 di aplikasi .NET Framework, 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 seperti 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>

Note

Jika upaya dilakukan untuk menulis ke file yang sedang digunakan atau tidak tersedia, nama file secara otomatis diawali oleh GUID.

Konstruktor

Nama	Deskripsi
TextWriterTraceListener()	Menginisialisasi instans TextWriterTraceListener baru kelas dengan TextWriter sebagai penerima output.
TextWriterTraceListener(Stream, String)	Menginisialisasi instans TextWriterTraceListener baru kelas dengan nama yang ditentukan, menggunakan aliran sebagai penerima output penelusuran kesalahan dan pelacakan.
TextWriterTraceListener(Stream)	Menginisialisasi instans TextWriterTraceListener baru kelas, menggunakan aliran sebagai penerima output penelusuran kesalahan dan pelacakan.
TextWriterTraceListener(String, String)	Menginisialisasi instans TextWriterTraceListener baru kelas dengan nama yang ditentukan, menggunakan file sebagai penerima output penelusuran kesalahan dan pelacakan.
TextWriterTraceListener(String)	Menginisialisasi instans TextWriterTraceListener baru kelas, menggunakan file sebagai penerima output penelusuran kesalahan dan pelacakan.
TextWriterTraceListener(TextWriter, String)	Menginisialisasi instans TextWriterTraceListener baru kelas dengan nama yang ditentukan, menggunakan penulis yang ditentukan sebagai penerima output pelacakan atau penelusuran kesalahan.
TextWriterTraceListener(TextWriter)	Menginisialisasi instans TextWriterTraceListener baru kelas menggunakan penulis yang ditentukan sebagai penerima output penelusuran atau penelusuran kesalahan.

Properti

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

Metode

Nama	Deskripsi
Close()	Writer Menutup sehingga tidak lagi menerima output pelacakan atau penelusuran kesalahan.
Dispose()	Merilis semua sumber daya yang digunakan oleh TraceListener. (Diperoleh dari TraceListener)
Dispose(Boolean)	Buang objek ini TextWriterTraceListener .
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. (Diperoleh dari TraceListener)
Fail(String)	Memancarkan pesan kesalahan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Flush()	Bersihkan buffer output untuk Writer.
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. (Diperoleh dari TraceListener)
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. (Diperoleh dari TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Menulis informasi pelacakan, array objek data, dan informasi peristiwa ke output spesifik pendengar. (Diperoleh dari TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Menulis informasi pelacakan, array objek dan informasi peristiwa yang diformat ke output spesifik pendengar. (Diperoleh dari TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Menulis informasi pelacakan, pesan, dan informasi peristiwa ke output spesifik pendengar. (Diperoleh dari TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Menulis jejak dan informasi peristiwa ke output spesifik pendengar. (Diperoleh dari TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Menulis informasi pelacakan, pesan, identitas aktivitas terkait, dan informasi peristiwa ke output spesifik pendengar. (Diperoleh dari TraceListener)
Write(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Write(Object)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Write(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Write(String)	Menulis pesan ke instans Writerini .
WriteIndent()	Menulis inden ke pendengar yang Anda buat saat mengimplementasikan kelas ini, dan mengatur ulang NeedIndent properti ke false. (Diperoleh dari TraceListener)
WriteLine(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti oleh terminator baris. (Diperoleh dari TraceListener)
WriteLine(Object)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti oleh terminator baris. (Diperoleh dari TraceListener)
WriteLine(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti oleh terminator baris. (Diperoleh dari TraceListener)
WriteLine(String)	Menulis pesan ke instans Writer ini diikuti oleh terminator baris. Terminator baris default adalah pengembalian pengangkutan diikuti oleh umpan baris (\r\n).

Lihat juga

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• Stream
• TextWriter
• Debug
• Trace