EventProvider.WriteMessageEvent Método

Definición

Espacio de nombres:

System.Diagnostics.Eventing

Ensamblado:

System.Core.dll

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 -> bool

Public Function WriteMessageEvent (eventMessage As String) As Boolean

Parámetros

eventMessage

String

Cadena que se va a escribir como los datos del evento.

Devoluciones

Boolean

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

ArgumentException

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.

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 -> bool

Public Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As Boolean

Pará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

Boolean

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

SecurityCriticalAttribute

Excepciones

ArgumentException

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.