TextWriterTraceListener Kelas

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

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 menghasilkan satu baris teks ke file. Terakhir, contoh menghapus buffer output.

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

void main()
{
   #if defined(TRACE)
   // 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 = 
      gcnew TextWriterTraceListener( myFile );
   Trace::Listeners->Add( myTextListener );
  
   // Write output to the file.
   Trace::Write( "Test output " );
  
   // Flush the output.
   Trace::Flush();
   Trace::Close();
   #endif
}

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.

Penting

Jenis ini mengimplementasikan IDisposable antarmuka. Ketika Anda telah selesai menggunakan jenis , Anda harus membuangnya baik secara langsung atau tidak langsung. Untuk membuang jenis secara langsung, panggil metodenya Dispose dalam try/catch blok. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using (dalam C#) atau Using (di Visual Basic). Untuk informasi selengkapnya, lihat bagian "Menggunakan Objek yang Mengimplementasikan IDisposable" dalam IDisposable topik antarmuka.

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, atau menambahkan #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 diatur 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>  

Catatan

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

Konstruktor

TextWriterTraceListener()	Menginisialisasi instans TextWriterTraceListener baru kelas dengan TextWriter sebagai penerima output.
TextWriterTraceListener(Stream)	Menginisialisasi instans TextWriterTraceListener baru kelas, menggunakan aliran sebagai penerima output penelusuran kesalahan dan pelacakan.
TextWriterTraceListener(Stream, String)	Menginisialisasi instans TextWriterTraceListener baru kelas dengan nama yang ditentukan, menggunakan aliran sebagai penerima output penelusuran kesalahan dan pelacakan.
TextWriterTraceListener(String)	Menginisialisasi instans TextWriterTraceListener baru kelas, menggunakan file 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(TextWriter)	Menginisialisasi instans TextWriterTraceListener baru kelas menggunakan penulis yang ditentukan sebagai penerima output pelacakan atau penelusuran kesalahan.
TextWriterTraceListener(TextWriter, String)	Menginisialisasi instans TextWriterTraceListener baru kelas dengan nama yang ditentukan, menggunakan penulis yang ditentukan sebagai penerima output pelacakan atau penelusuran kesalahan.

Properti

Attributes	Mendapatkan atribut listener pelacakan kustom yang ditentukan dalam file konfigurasi aplikasi. (Diperoleh dari TraceListener)
Filter	Mendapatkan atau mengatur filter pelacakan untuk pendengar pelacakan. (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 jejak aman untuk utas. (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 penelusuran atau penelusuran kesalahan.

Metode

Close()	Writer Menutup 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 . (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)	Memancarkan pesan kesalahan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Fail(String, String)	Memancarkan pesan kesalahan dan pesan kesalahan terperinci ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Flush()	Menghapus 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 pelacakan. (Diperoleh dari TraceListener)
GetType()	Mendapatkan 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 yang 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. (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)	Menulis informasi pelacakan dan peristiwa 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, String, Object[])	Menulis informasi pelacakan, array objek dan informasi peristiwa yang diformat 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)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (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(String)	Menulis pesan ke instans Writerini .
Write(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
WriteIndent()	Menulis inden ke pendengar yang Anda buat saat mengimplementasikan kelas ini, dan mengatur ulang NeedIndent properti ke false. (Diperoleh dari TraceListener)
WriteLine(Object)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris. (Diperoleh dari TraceListener)
WriteLine(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan 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).
WriteLine(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris. (Diperoleh dari TraceListener)

Lihat juga

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