TraceSource.TraceData Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.TraceSource.dll

Menulis data pelacakan ke pendengar jejak dalam Listeners koleksi.

Overload

TraceData(TraceEventType, Int32, Object)	Menulis data pelacakan ke pendengar pelacakan dalam Listeners koleksi menggunakan jenis peristiwa, pengidentifikasi peristiwa, dan data pelacakan yang ditentukan.
TraceData(TraceEventType, Int32, Object[])	Menulis data pelacakan ke pendengar pelacakan dalam Listeners koleksi menggunakan jenis peristiwa, pengidentifikasi peristiwa, dan array data pelacakan yang ditentukan.

TraceData(TraceEventType, Int32, Object)

Sumber:

TraceSource.cs

Menulis data pelacakan ke pendengar pelacakan dalam Listeners koleksi menggunakan jenis peristiwa, pengidentifikasi peristiwa, dan data pelacakan yang ditentukan.

public:
 void TraceData(System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);

[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, object? data);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unit

Public Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)

Parameter

eventType

TraceEventType

Salah satu nilai enumerasi yang menentukan jenis peristiwa data pelacakan.

id

Int32

Pengidentifikasi numerik untuk peristiwa tersebut.

data

Object

Data pelacakan.

Atribut

ConditionalAttribute

Pengecualian

ObjectDisposedException

Upaya dilakukan untuk melacak peristiwa selama finalisasi.

Contoh

Contoh kode berikut menunjukkan penggunaan TraceData(TraceEventType, Int32, Object) metode untuk memfilter dan meneruskan pesan pelacakan ke pendengar. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk TraceSource kelas .

// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
    "SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
    "SourceFilter should let this message through on the console trace listener.");

' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")

Keterangan

Metode TraceData ini, seperti TraceEvent metode , ditujukan untuk alat otomatis, tetapi juga memungkinkan pelampiran objek tambahan, seperti instans pengecualian, ke pelacakan.

Metode TraceData memanggil SourceSwitch.ShouldTrace metode objek yang SourceSwitch dikembalikan oleh Switch properti . Jika ShouldTrace mengembalikan true, TraceData memanggil metode yang TraceData sesuai pada semua pendengar. Jika tidak, TraceData kembali tanpa memanggil metode pendengar.

Catatan

Objek EventLogTraceListener dibatasi hingga nilai maksimum id 65.535. id Jika nilai yang ditentukan lebih besar dari 65.535, EventLogTraceListener objek menggunakan 65.535.

TraceData(TraceEventType, Int32, Object[])

Sumber:

TraceSource.cs

Menulis data pelacakan ke pendengar pelacakan dalam Listeners koleksi menggunakan jenis peristiwa, pengidentifikasi peristiwa, dan array data pelacakan yang ditentukan.

public:
 void TraceData(System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);

[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())

Parameter

eventType

TraceEventType

Salah satu nilai enumerasi yang menentukan jenis peristiwa data pelacakan.

id

Int32

Pengidentifikasi numerik untuk peristiwa tersebut.

data

Object[]

Array objek yang berisi data pelacakan.

Atribut

ConditionalAttribute

Pengecualian

ObjectDisposedException

Upaya dilakukan untuk melacak peristiwa selama finalisasi.

Keterangan

Metode ini TraceData , seperti TraceEvent metode , ditujukan untuk alat otomatis, tetapi juga memungkinkan pelampiran objek tambahan, seperti instans pengecualian dan jejak tumpukan, ke pelacakan.

Metode TraceData memanggil ShouldTrace metode objek yang SourceSwitch dikembalikan oleh Switch properti . Jika ShouldTrace mengembalikan true, TraceData memanggil metode yang TraceData sesuai pada semua pendengar. Jika tidak, TraceData kembali tanpa memanggil metode pendengar.

Catatan

Objek EventLogTraceListener dibatasi hingga nilai maksimum id 65.535. id Jika nilai yang ditentukan lebih besar dari 65.535, EventLogTraceListener objek menggunakan 65.535.