EventProvider.WriteMessageEvent Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics.Eventing

Zestaw:

System.Core.dll

Zapisuje zdarzenie zawierające ciąg jako dane.

Przeciążenia

WriteMessageEvent(String)	Zapisuje zdarzenie zawierające ciąg jako dane.
WriteMessageEvent(String, Byte, Int64)	Zapisuje zdarzenie zawierające ciąg jako dane, jeśli poziom i wartość słowa kluczowego są zgodne ze zdarzeniami żądanymi przez sesję.

Uwagi

Te metody nie wymagają manifestu do korzystania ze zdarzenia.

WriteMessageEvent(String)

Zapisuje zdarzenie zawierające ciąg jako dane.

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

Ciąg do zapisania jako danych zdarzenia.

Zwraca

Boolean

Czy true zdarzenie jest zapisywane; w przeciwnym razie . false Jeśli wartość false, wywołaj metodę GetLastWriteEventError() , aby określić przyczynę błędu.

Wyjątki

ArgumentException

Jeśli eventMessage wartość to null.

Przykłady

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

Uwagi

Maksymalna długość ciągu jest ograniczona do 64 KB pomniejszona o rozmiar nagłówków zdarzeń. Rozmiar zdarzenia jest mniejszy, jeśli rozmiar buforu sesji jest mniejszy, a sesja zawiera rozszerzone elementy danych ze zdarzeniem.

WriteMessageEvent(String, Byte, Int64)

Zapisuje zdarzenie zawierające ciąg jako dane, jeśli poziom i wartość słowa kluczowego są zgodne ze zdarzeniami żądanymi przez sesję.

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

Ciąg do zapisania jako danych zdarzenia.

eventLevel

Byte

Poziom szczegółowości uwzględniony w zdarzeniu. Jeśli dostawca używa manifestu do zdefiniowania zdarzenia, ustaw tę wartość na ten sam poziom zdefiniowany w manifeście.

eventKeywords

Int64

Maska bitowa określająca kategorię zdarzeń. Jeśli dostawca używa manifestu do zdefiniowania zdarzenia, ustaw tę wartość na tę samą maskę słowa kluczowego zdefiniowaną w manifeście.

Zwraca

Boolean

Czy true zdarzenie jest zapisywane; w przeciwnym razie . false Jeśli wartość false, wywołaj metodę GetLastWriteEventError() , aby określić przyczynę błędu.

Atrybuty

SecurityCriticalAttribute

Wyjątki

ArgumentException

Jeśli eventMessage wartość to null.

Przykłady

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

Uwagi

Maksymalna długość ciągu jest ograniczona do 64 KB pomniejszona o rozmiar nagłówków zdarzeń. Rozmiar zdarzenia jest mniejszy, jeśli rozmiar buforu sesji jest mniejszy, a sesja zawiera rozszerzone elementy danych ze zdarzeniem.