EventProvider.WriteMessageEvent Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Escribe un evento que contiene una cadena como datos.
Sobrecargas
| WriteMessageEvent(String) |
Escribe un evento que contiene una cadena como datos. |
| WriteMessageEvent(String, Byte, Int64) |
Escribe un evento que contiene una cadena como datos si el valor de nivel y palabra clave coinciden con los eventos solicitados por la sesión. |
Comentarios
Estos métodos no requieren un manifiesto para consumir el evento.
WriteMessageEvent(String)
Escribe un evento que contiene una cadena como datos.
public:
bool WriteMessageEvent(System::String ^ eventMessage);public bool WriteMessageEvent (string eventMessage);member this.WriteMessageEvent : string -> boolPublic Function WriteMessageEvent (eventMessage As String) As BooleanParámetros
- eventMessage
- String
Cadena que se va a escribir como los datos del evento.
Devoluciones
Es true si se escribe el evento; de lo contrario, es false. Si su valor es false, llame al método GetLastWriteEventError() para determinar la causa del error.
Excepciones
Si eventMessage es null.
Ejemplos
if (!provider.WriteMessageEvent("Event string."))
Console.WriteLine(EventProvider.GetLastWriteEventError());
Comentarios
La longitud máxima de la cadena se limita a 64 KB menos el tamaño de los encabezados de evento. El tamaño del evento será menor si el tamaño de búfer de la sesión es menor y la sesión incluye elementos de datos extendidos con el evento.
Se aplica a
WriteMessageEvent(String, Byte, Int64)
Escribe un evento que contiene una cadena como datos si el valor de nivel y palabra clave coinciden con los eventos solicitados por la sesión.
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 BooleanParámetros
- eventMessage
- String
Cadena que se va a escribir como los datos del evento.
- eventLevel
- Byte
Nivel de detalle que se incluye en el evento. Si el proveedor utiliza un manifiesto para definir el evento, establezca este valor en el mismo nivel definido en el manifiesto.
- eventKeywords
- Int64
Máscara de bits que especifica la categoría de evento. Si el proveedor utiliza un manifiesto para definir el evento, establezca este valor en la misma máscara de palabra clave definida en el manifiesto.
Devoluciones
Es true si se escribe el evento; de lo contrario, es false. Si su valor es false, llame al método GetLastWriteEventError() para determinar la causa del error.
- Atributos
Excepciones
Si eventMessage es null.
Ejemplos
// 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());
Comentarios
La longitud máxima de la cadena se limita a 64 KB menos el tamaño de los encabezados de evento. El tamaño del evento será menor si el tamaño de búfer de la sesión es menor y la sesión incluye elementos de datos extendidos con el evento.
