EventProvider.WriteMessageEvent Metode

Definisi

Ruang nama:

System.Diagnostics.Eventing

Rakitan:

System.Core.dll

Menulis peristiwa yang berisi string sebagai datanya.

Overload

WriteMessageEvent(String)	Menulis peristiwa yang berisi string sebagai datanya.
WriteMessageEvent(String, Byte, Int64)	Menulis peristiwa yang berisi string sebagai datanya jika tingkat dan nilai kata kunci cocok dengan peristiwa yang diminta oleh sesi.

Keterangan

Metode ini tidak memerlukan manifes untuk mengonsumsi peristiwa.

WriteMessageEvent(String)

Menulis peristiwa yang berisi string sebagai datanya.

public:
 bool WriteMessageEvent(System::String ^ eventMessage);

public bool WriteMessageEvent (string eventMessage);

member this.WriteMessageEvent : string -> bool

Public Function WriteMessageEvent (eventMessage As String) As Boolean

Parameter

eventMessage

String

String untuk ditulis sebagai data peristiwa.

Mengembalikan

Boolean

Apakah true jika peristiwa ditulis; jika tidak, false. Jika false, panggil GetLastWriteEventError() metode untuk menentukan penyebab kegagalan.

Pengecualian

ArgumentException

Jika eventMessage adalah null.

Contoh

if (!provider.WriteMessageEvent("Event string."))  
    Console.WriteLine(EventProvider.GetLastWriteEventError());  

Keterangan

Panjang string maksimum dibatasi hingga 64 KB dikurangi ukuran header peristiwa. Ukuran peristiwa lebih kecil jika ukuran buffer sesi kurang dan sesi menyertakan item data yang diperluas dengan peristiwa tersebut.

WriteMessageEvent(String, Byte, Int64)

Menulis peristiwa yang berisi string sebagai datanya jika tingkat dan nilai kata kunci cocok dengan peristiwa yang diminta oleh sesi.

public:
 bool WriteMessageEvent(System::String ^ eventMessage, System::Byte eventLevel, long eventKeywords);

[System.Security.SecurityCritical]
public bool WriteMessageEvent (string eventMessage, byte eventLevel, long eventKeywords);

[<System.Security.SecurityCritical>]
member this.WriteMessageEvent : string * byte * int64 -> bool

Public Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As Boolean

Parameter

eventMessage

String

String untuk ditulis sebagai data peristiwa.

eventLevel

Byte

Tingkat detail yang disertakan dalam peristiwa tersebut. Jika penyedia menggunakan manifes untuk menentukan peristiwa, atur nilai ini ke tingkat yang sama yang ditentukan dalam manifes.

eventKeywords

Int64

Masker bit yang menentukan kategori peristiwa. Jika penyedia menggunakan manifes untuk menentukan peristiwa, atur nilai ini ke topeng kata kunci yang sama yang ditentukan dalam manifes.

Mengembalikan

Boolean

Apakah true jika peristiwa ditulis; jika tidak, false. Jika false, panggil GetLastWriteEventError() metode untuk menentukan penyebab kegagalan.

Atribut

SecurityCriticalAttribute

Pengecualian

ArgumentException

Jika eventMessage adalah null.

Contoh

// Calling this method with level and keyword set to zero is the same  
// as calling WriteMessageEvent(string); the event is always written.  
if (!provider.WriteMessageEvent("Event string.", 0, 0))  
    Console.WriteLine(EventProvider.GetLastWriteEventError());  

// Event is written if the level value of the session is less than or equal to 3, and bit 1 of the session  
// keyword bit-mask is set.  
if (!provider.WriteMessageEvent("Event string.", 3, 2))  
    Console.WriteLine(EventProvider.GetLastWriteEventError());  

Keterangan

Panjang string maksimum dibatasi hingga 64 KB dikurangi ukuran header peristiwa. Ukuran peristiwa lebih kecil jika ukuran buffer sesi kurang dan sesi menyertakan item data yang diperluas dengan peristiwa tersebut.