EventProvider.WriteMessageEvent Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> boolPublic Function WriteMessageEvent (eventMessage As String) As BooleanParametri
- eventMessage
- String
Stringa da scrivere come dati dell'evento.
Restituisce
true se l'evento viene scritto, in caso contrario false. Se è false, chiamare il metodo GetLastWriteEventError() per determinare la causa dell'errore.
Eccezioni
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 -> boolPublic Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As BooleanParametri
- 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
true se l'evento viene scritto, in caso contrario false. Se è false, chiamare il metodo GetLastWriteEventError() per determinare la causa dell'errore.
- Attributi
Eccezioni
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.
