Bagikan melalui


TraceSource.TraceEvent Metode

Definisi

Menulis pesan peristiwa pelacakan ke pendengar jejak dalam Listeners koleksi.

Overload

TraceEvent(TraceEventType, Int32)

Menulis pesan peristiwa pelacakan ke pendengar jejak dalam Listeners koleksi menggunakan jenis peristiwa dan pengidentifikasi peristiwa yang ditentukan.

TraceEvent(TraceEventType, Int32, String)

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

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

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

TraceEvent(TraceEventType, Int32)

Sumber:
TraceSource.cs
Sumber:
TraceSource.cs
Sumber:
TraceSource.cs

Menulis pesan peristiwa pelacakan ke pendengar jejak dalam Listeners koleksi menggunakan jenis peristiwa dan pengidentifikasi peristiwa yang ditentukan.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

Parameter

eventType
TraceEventType

Salah satu nilai enumerasi yang menentukan jenis peristiwa data pelacakan.

id
Int32

Pengidentifikasi numerik untuk peristiwa tersebut.

Atribut

Pengecualian

Upaya dilakukan untuk melacak peristiwa selama finalisasi.

Contoh

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

ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)

Keterangan

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.

Metode TraceEvent memanggil ShouldTrace metode objek yang SourceSwitch dikembalikan oleh Switch properti . Jika ShouldTrace mengembalikan true, TraceEvent memanggil metode yang TraceEvent sesuai dari setiap pendengar. Jika tidak, TraceEvent kembali tanpa memanggil metode pendengar.

Konten pelacakan spesifik pendengar. Jika metode tidak ditimpa oleh implementasi pendengar, output default adalah nama sumber pelacakan, identitas numeriknya, dan jenis peristiwa. Konten pelacakan tambahan tergantung pada nilai properti pendengar TraceOutputOptions .

Catatan

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

Berlaku untuk

TraceEvent(TraceEventType, Int32, String)

Sumber:
TraceSource.cs
Sumber:
TraceSource.cs
Sumber:
TraceSource.cs

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

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

Parameter

eventType
TraceEventType

Salah satu nilai enumerasi yang menentukan jenis peristiwa data pelacakan.

id
Int32

Pengidentifikasi numerik untuk peristiwa tersebut.

message
String

Pesan pelacakan untuk ditulis.

Atribut

Pengecualian

Upaya dilakukan untuk melacak peristiwa selama finalisasi.

Contoh

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

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");
' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

Keterangan

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.

Metode TraceEvent memanggil ShouldTrace metode objek yang SourceSwitch dikembalikan oleh Switch properti . Jika ShouldTrace mengembalikan true, TraceEvent memanggil metode yang TraceEvent sesuai dari setiap pendengar. Jika tidak, TraceEvent kembali tanpa memanggil metode pendengar.

Konten pelacakan spesifik pendengar. Jika metode tidak ditimpa oleh implementasi pendengar, output default adalah nama sumber pelacakan, identitas numeriknya, jenis peristiwa, dan pesan. Konten pelacakan tambahan tergantung pada nilai properti pendengar TraceOutputOptions .

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.

Berlaku untuk

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

Sumber:
TraceSource.cs
Sumber:
TraceSource.cs
Sumber:
TraceSource.cs

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

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parameter

eventType
TraceEventType

Salah satu nilai enumerasi yang menentukan jenis peristiwa data pelacakan.

id
Int32

Pengidentifikasi numerik untuk peristiwa tersebut.

format
String

String format komposit yang berisi teks yang diintermiks dengan nol atau lebih item format, yang sesuai dengan objek dalam args array.

args
Object[]

Array object yang berisi nol atau beberapa objek untuk diformat.

Atribut

Pengecualian

formatadalah null.

format tidak valid.

-atau-

Angka yang menunjukkan argumen ke format kurang dari nol, atau lebih besar dari atau sama dengan jumlah objek yang ditentukan untuk diformat.

Upaya dilakukan untuk melacak peristiwa selama finalisasi.

Contoh

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

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");
' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

Keterangan

Untuk informasi selengkapnya tentang format parameter , lihat Pemformatan Komposit.

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.

Metode TraceEvent memanggil ShouldTrace metode objek yang SourceSwitch dikembalikan oleh Switch properti . Jika ShouldTrace mengembalikan true, TraceEvent memanggil metode yang TraceEvent sesuai dari setiap pendengar. Jika tidak, TraceEvent kembali tanpa memanggil metode pendengar.

Konten pelacakan spesifik pendengar. Metode default TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) menulis nama sumber, jenis peristiwa, dan identitas numerik di header pelacakan, lalu memanggil String.Format(IFormatProvider, String, Object[]) metode , meneruskan format string dan args array dan menggunakan CultureInfo.InvariantCulture properti untuk memformat string sebagai output pesan.

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.

Lihat juga

Berlaku untuk