EventProvider.WriteMessageEvent Methode

  • Referenz

Definition

Namespace:
System.Diagnostics.Eventing
Assembly:
System.Core.dll

Schreibt ein Ereignis, das als Daten eine Zeichenfolge enthält.

Überlädt

WriteMessageEvent(String)

Schreibt ein Ereignis, das als Daten eine Zeichenfolge enthält.
WriteMessageEvent(String, Byte, Int64)

Schreibt ein Ereignis, das als Daten eine Zeichenfolge enthält, wenn der Ebenen- und Schlüsselwortwert mit den von der Sitzung angeforderten Ereignissen übereinstimmen.

Hinweise

Für diese Methoden ist kein Manifest erforderlich, um das Ereignis zu nutzen.

WriteMessageEvent(String)

Schreibt ein Ereignis, das als Daten eine Zeichenfolge enthält.

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

Als Ereignisdaten zu schreibende Zeichenfolge.

Gibt zurück

Boolean

Ist true, wenn das Ereignis geschrieben wird, andernfalls false. Wenn der Wert false ist, rufen Sie die GetLastWriteEventError()-Methode auf, um die Ursache des Fehlers zu ermitteln.

Ausnahmen

ArgumentException

Wenn eventMessage gleich null ist.

Beispiele

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

Hinweise

Die maximale Zeichenfolgenlänge ist auf 64 KB abzüglich der Größe der Ereignisheader beschränkt. Die Ereignisgröße ist geringer, wenn die Puffergröße der Sitzung geringer ist und die Sitzung erweiterte Datenelemente für das Ereignis enthält.

Gilt für:

WriteMessageEvent(String, Byte, Int64)

Schreibt ein Ereignis, das als Daten eine Zeichenfolge enthält, wenn der Ebenen- und Schlüsselwortwert mit den von der Sitzung angeforderten Ereignissen übereinstimmen.

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

Als Ereignisdaten zu schreibende Zeichenfolge.

eventLevel
Byte

Die Detailebene im Ereignis. Wenn der Anbieter das Ereignis mit einem Manifest definiert, legen Sie diesen Wert auf die im Manifest definierte Ebene fest.

eventKeywords
Int64

Bitmaske, die die Ereigniskategorie angibt. Wenn der Anbieter das Ereignis mit einem Manifest definiert, legen Sie diesen Wert auf die im Manifest definierte Schlüsselwortmaske fest.

Gibt zurück

Boolean

Ist true, wenn das Ereignis geschrieben wird, andernfalls false. Wenn der Wert false ist, rufen Sie die GetLastWriteEventError()-Methode auf, um die Ursache des Fehlers zu ermitteln.

Attribute
SecurityCriticalAttribute

Ausnahmen

ArgumentException

Wenn eventMessage gleich null ist.

Beispiele

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

Hinweise

Die maximale Zeichenfolgenlänge ist auf 64 KB abzüglich der Größe der Ereignisheader beschränkt. Die Ereignisgröße ist geringer, wenn die Puffergröße der Sitzung geringer ist und die Sitzung erweiterte Datenelemente für das Ereignis enthält.

Gilt für: