EventProvider.WriteMessageEvent Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Diagnostics.Eventing
Assembly:
System.Core.dll

Scrive un evento che contiene una stringa come i relativi dati.

Overload

WriteMessageEvent(String)

Scrive un evento che contiene una stringa come i relativi dati.
WriteMessageEvent(String, Byte, Int64)

Scrive un evento che contiene una stringa come i relativi dati se il valore di livello e parola chiave corrispondono agli eventi richiesti dalla sessione.

Commenti

Questi metodi non richiedono un manifesto per utilizzare l'evento.

WriteMessageEvent(String)

Scrive un evento che contiene una stringa come i relativi dati.

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

Parametri

eventMessage
String

Stringa da scrivere come dati dell'evento.

Restituisce

Boolean

true se l'evento viene scritto, in caso contrario false. Se è false, chiamare il metodo GetLastWriteEventError() per determinare la causa dell'errore.

Eccezioni

ArgumentException

Se eventMessage è null.

Esempio

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

Commenti

La lunghezza massima della stringa è limitata a 64 KB meno le dimensioni delle intestazioni dell'evento. Se la sessione ha una dimensione del buffer ridotta e include elementi di dati estesi con l'evento, la dimensione dell'evento sarà ridotta.

Si applica a

WriteMessageEvent(String, Byte, Int64)

Scrive un evento che contiene una stringa come i relativi dati se il valore di livello e parola chiave corrispondono agli eventi richiesti dalla sessione.

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

Parametri

eventMessage
String

Stringa da scrivere come dati dell'evento.

eventLevel
Byte

Livello di dettaglio incluso nell'evento. Se il provider utilizza un manifesto per definire l'evento, impostare questo valore sullo stesso livello definito nel manifesto.

eventKeywords
Int64

Maschera di bit che specifica la categoria di eventi. Se il provider utilizza un manifesto per definire l'evento, impostare questo valore sulla stessa maschera di parola chiave definita nel manifesto.

Restituisce

Boolean

true se l'evento viene scritto, in caso contrario false. Se è false, chiamare il metodo GetLastWriteEventError() per determinare la causa dell'errore.

Attributi
SecurityCriticalAttribute

Eccezioni

ArgumentException

Se eventMessage è null.

Esempio

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

Commenti

La lunghezza massima della stringa è limitata a 64 KB meno le dimensioni delle intestazioni dell'evento. Se la sessione ha una dimensione del buffer ridotta e include elementi di dati estesi con l'evento, la dimensione dell'evento sarà ridotta.

Si applica a