EventLogTraceListener.TraceEvent Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Menulis informasi pelacakan peristiwa ke log peristiwa.

Overload

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Menulis informasi pelacakan, pesan, dan informasi peristiwa ke log peristiwa.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Menulis informasi pelacakan, array objek yang diformat, dan informasi peristiwa ke log peristiwa.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Sumber:

EventLogTraceListener.cs

Menulis informasi pelacakan, pesan, dan informasi peristiwa ke log peristiwa.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);

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

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

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

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.

message

String

Pesan pelacakan.

Atribut

ComVisibleAttribute

Pengecualian

ArgumentException

sourcetidak ditetapkan.

-atau-

String entri log melebihi 32.766 karakter.

Keterangan

Penting

Metode TraceEvent ini tidak dimaksudkan untuk dipanggil oleh kode aplikasi. Metode ini dipanggil dengan metode Debugkelas , , Tracedan TraceSource untuk menulis data pelacakan.

Metode TraceEvent ini dimaksudkan untuk melacak peristiwa yang dapat diproses secara otomatis oleh alat. Misalnya alat pemantauan dapat memberi tahu administrator jika peristiwa tertentu dilacak oleh sumber tertentu.

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 message data menggunakan WriteEvent metode .

Catatan

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

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

Sumber:

EventLogTraceListener.cs

Menulis informasi pelacakan, array objek yang diformat, dan informasi peristiwa ke log peristiwa.

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

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

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

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args 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.

format

String

String format yang berisi nol atau beberapa item format yang sesuai dengan objek dalam args array.

args

Object[]

Array object yang berisi nol atau beberapa objek untuk diformat.

Atribut

ComVisibleAttribute

Pengecualian

ArgumentException

sourcetidak ditetapkan.

-atau-

String entri log melebihi 32.766 karakter.

Keterangan

Penting

Metode TraceEvent ini tidak dimaksudkan untuk dipanggil oleh kode aplikasi. Metode ini dipanggil dengan metode Debugkelas , , Tracedan TraceSource untuk menulis data pelacakan.

Metode TraceEvent ini dimaksudkan untuk melacak peristiwa yang dapat diproses secara otomatis oleh alat. Misalnya alat pemantauan dapat memberi tahu administrator jika peristiwa tertentu dilacak oleh sumber tertentu.

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, menggunakan WriteEvent metode , dengan pesan yang diperoleh dari format parameter dan args . Array args objek dikonversi menjadi string menggunakan Format metode , meneruskan format string dan args array untuk memformat string sebagai pesan untuk log peristiwa.

Catatan

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