EventLogTraceListener.TraceData Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Menulis data pelacakan ke log peristiwa.

Overload

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Menulis informasi pelacakan, objek data, dan informasi peristiwa ke log peristiwa.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Menulis informasi pelacakan, array objek data, dan informasi peristiwa ke log peristiwa.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Sumber:

EventLogTraceListener.cs

Menulis informasi pelacakan, objek data, dan informasi peristiwa ke log peristiwa.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, object data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data As Object)

Parameter

eventCache

TraceEventCache

Objek yang berisi ID proses saat ini, ID utas, dan informasi pelacakan tumpukan.

source

String

Nama yang digunakan untuk mengidentifikasi output; biasanya nama aplikasi yang menghasilkan peristiwa pelacakan.

severity

TraceEventType

Salah satu nilai enumerasi yang menentukan jenis peristiwa yang telah menyebabkan jejak.

id

Int32

Pengidentifikasi numerik untuk peristiwa tersebut. Kombinasi source dan id secara unik mengidentifikasi peristiwa.

data

Object

Objek data untuk ditulis ke file atau aliran output.

Atribut

ComVisibleAttribute

Pengecualian

ArgumentException

sourcetidak ditetapkan.

-atau-

String entri log melebihi 32.766 karakter.

Keterangan

Penting

Metode TraceData ini tidak dimaksudkan untuk dipanggil oleh kode aplikasi. Mereka dipanggil dengan metode Debugkelas , , Tracedan TraceSource untuk menghasilkan data pelacakan.

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

Parameter eventCache dan source digunakan untuk menentukan apakah peristiwa harus dilacak. id digunakan untuk membuat EventInstance objek dan disamakan TraceEventType dengan EventLogEntryType untuk EntryType properti . EventInstance ditulis ke log peristiwa dengan objek , diformat data sebagai string, menggunakan WriteEvent metode .

Catatan

Nilai id maksimum parameter adalah 65.535. id Jika nilai yang ditentukan lebih besar dari 65.535, nilai maksimum digunakan.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Sumber:

EventLogTraceListener.cs

Menulis informasi pelacakan, array objek data, dan informasi peristiwa ke log peristiwa.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, ... cli::array <System::Object ^> ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, params object[] data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data As Object())

Parameter

eventCache

TraceEventCache

Objek yang berisi ID proses saat ini, ID utas, dan informasi pelacakan tumpukan.

source

String

Nama yang digunakan untuk mengidentifikasi output; biasanya nama aplikasi yang menghasilkan peristiwa pelacakan.

severity

TraceEventType

Salah satu nilai enumerasi yang menentukan jenis peristiwa yang telah menyebabkan jejak.

id

Int32

Pengidentifikasi numerik untuk peristiwa tersebut. Kombinasi source dan id secara unik mengidentifikasi peristiwa.

data

Object[]

Array objek data.

Atribut

ComVisibleAttribute

Pengecualian

ArgumentException

sourcetidak ditetapkan.

-atau-

String entri log melebihi 32.766 karakter.

Keterangan

Penting

Metode TraceData ini tidak dimaksudkan untuk dipanggil oleh kode aplikasi. Mereka dipanggil dengan metode Debugkelas , , Tracedan TraceSource untuk menghasilkan data pelacakan.

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

Data severity parameter dan id digunakan untuk membuat EventInstance objek, yang ditulis ke log peristiwa dengan data dari array objek data.

Parameter eventCache dan source digunakan untuk menentukan apakah peristiwa harus dilacak. id digunakan untuk membuat EventInstance objek dan disamakan TraceEventType dengan EventLogEntryType untuk EntryType properti . EventInstance ditulis ke log peristiwa dengan data array objek, diformat sebagai array string, menggunakan WriteEvent metode .

Catatan

Nilai id maksimum parameter adalah 65.535. id Jika nilai yang ditentukan lebih besar dari 65.535, nilai maksimum digunakan.