EventProvider.WriteMessageEvent Método

Definição

Namespace:

System.Diagnostics.Eventing

Assembly:

System.Core.dll

Grava um evento que contém uma cadeia de caracteres como seus dados.

Sobrecargas

WriteMessageEvent(String)	Grava um evento que contém uma cadeia de caracteres como seus dados.
WriteMessageEvent(String, Byte, Int64)	Grava um evento que contém uma cadeia de caracteres como os dados, se o valor de nível e o valor de palavra-chave corresponde aos eventos solicitados pela sessão.

Comentários

Esses métodos não exigem um manifesto para consumir o evento.

WriteMessageEvent(String)

Grava um evento que contém uma cadeia de caracteres como seus dados.

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

A cadeia de caracteres a ser gravada como os dados do evento.

Retornos

Boolean

É true se o evento for escrito; caso contrário, false. Se falso, chame o método GetLastWriteEventError() para determinar a causa da falha.

Exceções

ArgumentException

Se eventMessage for null.

Exemplos

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

Comentários

O comprimento máximo da cadeia de caracteres é limitado a 64 KB menos o tamanho dos cabeçalhos de evento. O tamanho do evento será menor se o tamanho do buffer da sessão for menor e a sessão incluir itens de dados estendidos com o evento.

WriteMessageEvent(String, Byte, Int64)

Grava um evento que contém uma cadeia de caracteres como os dados, se o valor de nível e o valor de palavra-chave corresponde aos eventos solicitados pela sessão.

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

A cadeia de caracteres a ser gravada como os dados do evento.

eventLevel

Byte

Nível de detalhe incluído no evento. Se o provedor usar um manifesto para definir o evento, defina esse valor para o mesmo nível definido no manifesto.

eventKeywords

Int64

Bitmask que especifica a categoria do evento. Se o provedor usar um manifesto para definir o evento, defina esse valor para a mesma máscara de palavra-chave definida no manifesto.

Retornos

Boolean

É true se o evento for escrito; caso contrário, false. Se falso, chame o método GetLastWriteEventError() para determinar a causa da falha.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentException

Se eventMessage for null.

Exemplos

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

Comentários

O comprimento máximo da cadeia de caracteres é limitado a 64 KB menos o tamanho dos cabeçalhos de evento. O tamanho do evento será menor se o tamanho do buffer da sessão for menor e a sessão incluir itens de dados estendidos com o evento.