EventProvider.WriteMessageEvent Yöntem

Tanım

Ad Alanı:

System.Diagnostics.Eventing

Bütünleştirilmiş Kod:

System.Core.dll

Verileri olarak dize içeren bir olay yazar.

Aşırı Yüklemeler

WriteMessageEvent(String)	Verileri olarak dize içeren bir olay yazar.
WriteMessageEvent(String, Byte, Int64)	Düzey ve anahtar sözcük değeri oturum tarafından istenen olaylarla eşleşiyorsa verileri olarak dize içeren bir olay yazar.

Açıklamalar

Bu yöntemler, olayı kullanmak için bir bildirim gerektirmez.

WriteMessageEvent(String)

Verileri olarak dize içeren bir olay yazar.

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

public bool WriteMessageEvent (string eventMessage);

member this.WriteMessageEvent : string -> bool

Public Function WriteMessageEvent (eventMessage As String) As Boolean

Parametreler

eventMessage

String

Olay verileri olarak yazacak dize.

Döndürülenler

Boolean

Olay true yazıldıysa, yazıldıysa, falseolur. False ise, hatanın GetLastWriteEventError() nedenini belirlemek için yöntemini çağırın.

Özel durumlar

ArgumentException

ise eventMessagenull.

Örnekler

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

Açıklamalar

En fazla dize uzunluğu, olay üst bilgilerinin boyutu çıkarılırken 64 KB ile sınırlıdır. Oturumun arabellek boyutu daha küçükse ve oturum olayla birlikte genişletilmiş veri öğeleri içeriyorsa olay boyutu daha azdır.

WriteMessageEvent(String, Byte, Int64)

Düzey ve anahtar sözcük değeri oturum tarafından istenen olaylarla eşleşiyorsa verileri olarak dize içeren bir olay yazar.

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

Parametreler

eventMessage

String

Olay verileri olarak yazacak dize.

eventLevel

Byte

Etkinliğe dahil edilen ayrıntı düzeyi. Sağlayıcı olayı tanımlamak için bir bildirim kullanıyorsa, bu değeri bildirimde tanımlanan düzeye ayarlayın.

eventKeywords

Int64

Olay kategorisini belirten bit maskesi. Sağlayıcı olayı tanımlamak için bir bildirim kullanıyorsa, bu değeri bildirimde tanımlanan anahtar sözcük maskesine ayarlayın.

Döndürülenler

Boolean

Olay true yazıldıysa, yazıldıysa, falseolur. False ise, hatanın GetLastWriteEventError() nedenini belirlemek için yöntemini çağırın.

Öznitelikler

SecurityCriticalAttribute

Özel durumlar

ArgumentException

ise eventMessagenull.

Örnekler

// 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());  

Açıklamalar

En fazla dize uzunluğu, olay üst bilgilerinin boyutu çıkarılırken 64 KB ile sınırlıdır. Oturumun arabellek boyutu daha küçükse ve oturum olayla birlikte genişletilmiş veri öğeleri içeriyorsa olay boyutu daha azdır.