EventProvider.WriteMessageEvent Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> boolPublic Function WriteMessageEvent (eventMessage As String) As BooleanParameter
- eventMessage
- String
Als Ereignisdaten zu schreibende Zeichenfolge.
Gibt zurück
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
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 -> boolPublic Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As BooleanParameter
- 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
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
Ausnahmen
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.
