EventProvider.WriteMessageEvent Metod

Definition

Namnområde:
System.Diagnostics.Eventing
Sammansättning:
System.Core.dll

Skriver en händelse som innehåller en sträng som data.

Överlagringar

Name Description
WriteMessageEvent(String)

Skriver en händelse som innehåller en sträng som data.
WriteMessageEvent(String, Byte, Int64)

Skriver en händelse som innehåller en sträng som dess data om nivå- och nyckelordsvärdet matchar de händelser som begärdes av sessionen.

Kommentarer

Dessa metoder kräver inte något manifest för att använda händelsen.

WriteMessageEvent(String)

Skriver en händelse som innehåller en sträng som data.

public:
 bool WriteMessageEvent(System::String ^ eventMessage);
public bool WriteMessageEvent(string eventMessage);
member this.WriteMessageEvent : string -> bool
Public Function WriteMessageEvent (eventMessage As String) As Boolean

Parametrar

eventMessage
String

Sträng som ska skrivas som händelsedata.

Returer

Boolean

Är true om händelsen skrivs, annars . false Om det är falskt anropar du GetLastWriteEventError() metoden för att fastställa orsaken till felet.

Undantag

ArgumentException

Om eventMessage är null.

Exempel

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

Kommentarer

Den maximala stränglängden är begränsad till 64 kB minus storleken på händelserubrikerna. Händelsestorleken är mindre om sessionens buffertstorlek är mindre och sessionen innehåller utökade dataobjekt med händelsen.

Gäller för

WriteMessageEvent(String, Byte, Int64)

Skriver en händelse som innehåller en sträng som dess data om nivå- och nyckelordsvärdet matchar de händelser som begärdes av sessionen.

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

Parametrar

eventMessage
String

Sträng som ska skrivas som händelsedata.

eventLevel
Byte

Detaljnivå som ingår i händelsen. Om providern använder ett manifest för att definiera händelsen anger du det här värdet till samma nivå som definierats i manifestet.

eventKeywords
Int64

Bitmask som anger händelsekategorin. Om providern använder ett manifest för att definiera händelsen anger du det här värdet till samma nyckelordsmask som definierats i manifestet.

Returer

Boolean

Är true om händelsen skrivs, annars . false Om det är falskt anropar du GetLastWriteEventError() metoden för att fastställa orsaken till felet.

Attribut
SecurityCriticalAttribute

Undantag

ArgumentException

Om eventMessage är null.

Exempel

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

Kommentarer

Den maximala stränglängden är begränsad till 64 kB minus storleken på händelserubrikerna. Händelsestorleken är mindre om sessionens buffertstorlek är mindre och sessionen innehåller utökade dataobjekt med händelsen.

Gäller för