TraceSource.TraceEvent Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.TraceSource.dll

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

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

ConditionalAttribute

Pengecualian

ObjectDisposedException

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.

TraceEvent(TraceEventType, Int32, String)

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")>]
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

ConditionalAttribute

Pengecualian

ObjectDisposedException

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.

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

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")>]
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

ConditionalAttribute

Pengecualian

ArgumentNullException

formatadalah null.

FormatException

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.

ObjectDisposedException

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

• Pemformatan Komposit
• String Format Numerik Standar
• String Format Numerik Kustom
• String Format DateTime Standar
• String Format DateTime Kustom
• String format enumerasi
• Tipe Pemformatan di .NET