EventProvider.WriteMessageEvent Metoda

Definice

Obor názvů:

System.Diagnostics.Eventing

Sestavení:

System.Core.dll

Zapíše událost, která jako data obsahuje řetězec.

Přetížení

WriteMessageEvent(String)	Zapíše událost, která jako data obsahuje řetězec.
WriteMessageEvent(String, Byte, Int64)	Zapíše událost, která obsahuje řetězec jako svá data, pokud hodnota úrovně a klíčového slova odpovídají událostem požadovaným relací.

Poznámky

Tyto metody nevyžadují manifest ke zpracování události.

WriteMessageEvent(String)

Zapíše událost, která jako data obsahuje řetězec.

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

public bool WriteMessageEvent (string eventMessage);

member this.WriteMessageEvent : string -> bool

Public Function WriteMessageEvent (eventMessage As String) As Boolean

Parametry

eventMessage

String

Řetězec, který se má zapisovat jako data události.

Návraty

Boolean

Je true , pokud je událost zapsána; v opačném případě false. Pokud je false, zavolejte metodu GetLastWriteEventError() a určete příčinu selhání.

Výjimky

ArgumentException

Pokud eventMessage je null.

Příklady

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

Poznámky

Maximální délka řetězce je omezena na 64 kB minus velikost hlaviček událostí. Velikost události je menší, pokud je velikost vyrovnávací paměti relace menší a relace zahrnuje rozšířené datové položky s událostí.

WriteMessageEvent(String, Byte, Int64)

Zapíše událost, která obsahuje řetězec jako svá data, pokud hodnota úrovně a klíčového slova odpovídají událostem požadovaným relací.

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

Parametry

eventMessage

String

Řetězec, který se má zapisovat jako data události.

eventLevel

Byte

Úroveň podrobností zahrnutých v události Pokud zprostředkovatel k definování události používá manifest, nastavte tuto hodnotu na stejnou úroveň definovanou v manifestu.

eventKeywords

Int64

Bitová maska, která určuje kategorii události. Pokud zprostředkovatel používá manifest k definování události, nastavte tuto hodnotu na stejnou masku klíčového slova definovanou v manifestu.

Návraty

Boolean

Je true , pokud je událost zapsána; v opačném případě false. Pokud je false, zavolejte metodu GetLastWriteEventError() a určete příčinu selhání.

Atributy

SecurityCriticalAttribute

Výjimky

ArgumentException

Pokud eventMessage je null.

Příklady

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

Poznámky

Maximální délka řetězce je omezena na 64 kB minus velikost hlaviček událostí. Velikost události je menší, pokud je velikost vyrovnávací paměti relace menší a relace zahrnuje rozšířené datové položky s událostí.