EventProvider.WriteMessageEvent Metoda

Definice

Obor názvů:

System.Diagnostics.Eventing

Sestavení:

System.Core.dll

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

Přetížení

WriteMessageEvent(String)	Zapíše událost, která obsahuje řetězec jako svá data.
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 k využití události nevyžadují manifest.

WriteMessageEvent(String)

Zapíše událost, která obsahuje řetězec jako svá 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

Parametry

eventMessage

String

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

Návraty

Boolean

Je true , pokud je událost zapsána, jinak hodnota 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 omezená 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á zapsat jako data události.

eventLevel

Byte

Úroveň podrobností zahrnutých v události Pokud zprostředkovatel používá manifest k definování události, 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, jinak hodnota 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 omezená 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í.