EventProvider.WriteMessageEvent Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee schrijft u een gebeurtenis die een tekenreeks als gegevens bevat.
Overloads
| Name | Description |
|---|---|
| WriteMessageEvent(String) |
Hiermee schrijft u een gebeurtenis die een tekenreeks als gegevens bevat. |
| WriteMessageEvent(String, Byte, Int64) |
Hiermee schrijft u een gebeurtenis die een tekenreeks als gegevens bevat als het niveau en de trefwoordwaarde overeenkomen met de gebeurtenissen die door de sessie zijn aangevraagd. |
Opmerkingen
Voor deze methoden is geen manifest vereist om de gebeurtenis te gebruiken.
WriteMessageEvent(String)
Hiermee schrijft u een gebeurtenis die een tekenreeks als gegevens bevat.
public:
bool WriteMessageEvent(System::String ^ eventMessage);public bool WriteMessageEvent(string eventMessage);member this.WriteMessageEvent : string -> boolPublic Function WriteMessageEvent (eventMessage As String) As BooleanParameters
- eventMessage
- String
Tekenreeks die moet worden geschreven als de gebeurtenisgegevens.
Retouren
Is true als de gebeurtenis is geschreven; anders. false Als dit onwaar is, roept u de GetLastWriteEventError() methode aan om de oorzaak van de fout te bepalen.
Uitzonderingen
Als eventMessage dat het is null.
Voorbeelden
if (!provider.WriteMessageEvent("Event string."))
Console.WriteLine(EventProvider.GetLastWriteEventError());
Opmerkingen
De maximale tekenreekslengte is beperkt tot 64 kB min de grootte van de gebeurtenisheaders. De gebeurtenisgrootte is kleiner als de buffergrootte van de sessie kleiner is en de sessie uitgebreide gegevensitems bevat met de gebeurtenis.
Van toepassing op
WriteMessageEvent(String, Byte, Int64)
Hiermee schrijft u een gebeurtenis die een tekenreeks als gegevens bevat als het niveau en de trefwoordwaarde overeenkomen met de gebeurtenissen die door de sessie zijn aangevraagd.
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 BooleanParameters
- eventMessage
- String
Tekenreeks die moet worden geschreven als de gebeurtenisgegevens.
- eventLevel
- Byte
Detailniveau dat is opgenomen in de gebeurtenis. Als de provider een manifest gebruikt om de gebeurtenis te definiëren, stelt u deze waarde in op hetzelfde niveau dat in het manifest is gedefinieerd.
- eventKeywords
- Int64
Bitmasker waarmee de gebeurteniscategorie wordt opgegeven. Als de provider een manifest gebruikt om de gebeurtenis te definiëren, stelt u deze waarde in op hetzelfde trefwoordmasker dat in het manifest is gedefinieerd.
Retouren
Is true als de gebeurtenis is geschreven; anders. false Als dit onwaar is, roept u de GetLastWriteEventError() methode aan om de oorzaak van de fout te bepalen.
- Kenmerken
Uitzonderingen
Als eventMessage dat het is null.
Voorbeelden
// 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());
Opmerkingen
De maximale tekenreekslengte is beperkt tot 64 kB min de grootte van de gebeurtenisheaders. De gebeurtenisgrootte is kleiner als de buffergrootte van de sessie kleiner is en de sessie uitgebreide gegevensitems bevat met de gebeurtenis.
