DelimitedListTraceListener Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengarahkan output pelacakan atau penelusuran kesalahan ke penulis teks, seperti penulis aliran, atau ke aliran, seperti aliran file.
public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener
public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener
type DelimitedListTraceListener = class
inherit TextWriterTraceListener
Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener
- Warisan
- Warisan
Keterangan
Output jejak dalam format teks dibatasi yang menggunakan pemisah yang ditentukan melalui properti Delimiter. Pemisah digunakan untuk mengakhiri setiap bidang dalam baris output. Misalnya, untuk menampilkan output jejak dalam spreadsheet Microsoft Excel, Anda dapat menentukan koma (",") sebagai pemisah dan membuat file nilai yang dipisahkan koma (CSV).
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 dalamtry
/catch
blok. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using
(di C#) atau Using
(di Visual Basic). Untuk informasi selengkapnya, lihat bagian "Menggunakan Objek yang Mengimplementasikan IDisposable" di IDisposable topik antarmuka.
Anda dapat membuat DelimitedListTraceListener dalam kode Anda. Atau, hanya di aplikasi .NET Framework, Anda dapat mengaktifkan atau menonaktifkan DelimitedListTraceListener melalui file konfigurasi aplikasi lalu menggunakan yang dikonfigurasi DelimitedListTraceListener dalam aplikasi Anda.
Catatan
Hanya DelimitedListTraceListener memisahkan teks yang dipancarkan dengan menggunakan metode yang memiliki nama yang dimulai dengan kata Trace
, seperti DelimitedListTraceListener.TraceEvent atau Trace.TraceWarning. Lacak data yang dipancarkan dengan menggunakan Debug.Write metode dan TextWriterTraceListener.WriteLine tidak dibatasi.
Untuk mengonfigurasi DelimitedListTraceListener di aplikasi .NET Framework, edit file konfigurasi yang sesuai dengan nama aplikasi Anda. Dalam file ini, Anda dapat menambahkan pendengar, mengatur properti untuk pendengar, atau menghapus pendengar. File konfigurasi harus diformat seperti yang ditunjukkan dalam contoh berikut:
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="delimitedListener"
type="System.Diagnostics.DelimitedListTraceListener"
delimiter=","
initializeData="delimitedOutput.csv"
traceOutputOptions="ProcessId, DateTime" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Catatan
Jika Anda mencoba menulis ke file yang sedang digunakan atau tidak tersedia, nama file secara otomatis diawali oleh GUID.
Catatan
Pendengar dimaksudkan untuk digunakan oleh metode Debugkelas , , Tracedan TraceSource untuk menulis informasi pelacakan. Metode pendengar, kecuali untuk konstruktor, tidak boleh dipanggil langsung dari kode aplikasi.
Konstruktor
DelimitedListTraceListener(Stream) |
Menginisialisasi instans baru kelas DelimitedListTraceListener yang menulis ke aliran output yang ditentukan. |
DelimitedListTraceListener(Stream, String) |
Menginisialisasi instans DelimitedListTraceListener baru kelas yang menulis ke aliran output yang ditentukan dan memiliki nama yang ditentukan. |
DelimitedListTraceListener(String) |
Menginisialisasi instans baru kelas DelimitedListTraceListener yang menulis ke file yang ditentukan. |
DelimitedListTraceListener(String, String) |
Menginisialisasi instans baru kelas DelimitedListTraceListener yang menulis ke file yang ditentukan dan memiliki nama yang ditentukan. |
DelimitedListTraceListener(TextWriter) |
Menginisialisasi instans baru kelas DelimitedListTraceListener yang menulis ke penulis teks yang ditentukan. |
DelimitedListTraceListener(TextWriter, String) |
Menginisialisasi instans baru kelas DelimitedListTraceListener yang menulis ke penulis teks yang ditentukan dan memiliki nama yang ditentukan. |
Properti
Attributes |
Mendapatkan atribut pendengar pelacakan kustom yang ditentukan dalam file konfigurasi aplikasi. (Diperoleh dari TraceListener) |
Delimiter |
Mendapatkan atau mengatur pemisah untuk daftar yang dibatasi. |
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 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. (Diperoleh dari TextWriterTraceListener) |
Metode
Close() |
Writer Menutup sehingga tidak lagi menerima output pelacakan atau penelusuran kesalahan. (Diperoleh dari TextWriterTraceListener) |
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 obyek ini TextWriterTraceListener . (Diperoleh dari 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. (Diperoleh dari TextWriterTraceListener) |
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() |
Mengembalikan atribut file konfigurasi kustom yang didukung oleh pendengar pelacakan yang dibatasi. |
GetSupportedAttributes() |
Mendapatkan atribut kustom yang didukung oleh pendengar pelacakan. (Diperoleh dari TraceListener) |
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 file atau aliran output. |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Menulis informasi pelacakan, array objek data, dan informasi peristiwa ke file atau aliran output. |
TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Menulis jejak dan informasi peristiwa ke output spesifik pendengar. (Diperoleh dari TraceListener) |
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Menulis informasi pelacakan, pesan, dan informasi peristiwa ke file atau aliran output. |
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Menulis informasi pelacakan, array objek yang diformat, dan informasi peristiwa ke file atau aliran output. |
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. (Diperoleh dari TextWriterTraceListener) |
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 |
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 dengan terminator baris. Terminator baris default adalah pengembalian pengangkutan diikuti oleh umpan baris (\r\n). (Diperoleh dari TextWriterTraceListener) |
WriteLine(String, String) |
Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris. (Diperoleh dari TraceListener) |