EventProvider.WriteMessageEvent Método

Definición

Espacio de nombres:

System.Diagnostics.Eventing

Ensamblado:

System.Core.dll

Escribe un evento que contiene una cadena como sus datos.

Sobrecargas

Nombre	Description
WriteMessageEvent(String)	Escribe un evento que contiene una cadena como sus datos.
WriteMessageEvent(String, Byte, Int64)	Escribe un evento que contiene una cadena como sus 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 sus 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, falsees . Si es false, llame al GetLastWriteEventError() método 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 cadena se limita a 64 KB menos el tamaño de los encabezados de evento. El tamaño del evento es menor si el tamaño del 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 sus 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 incluido en el evento. Si el proveedor usa 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 eventos. Si el proveedor usa 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, falsees . Si es false, llame al GetLastWriteEventError() método 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 cadena se limita a 64 KB menos el tamaño de los encabezados de evento. El tamaño del evento es menor si el tamaño del búfer de la sesión es menor y la sesión incluye elementos de datos extendidos con el evento.