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

Nome Description
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 seus dados se o nível e o valor da palavra-chave corresponderem 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

Cadeia de caracteres para gravar como os dados do evento.

Retornos

Boolean

É true se o evento for gravado; caso contrário, false. Se for falso, chame o GetLastWriteEventError() método 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.

Aplica-se a

WriteMessageEvent(String, Byte, Int64)

Grava um evento que contém uma cadeia de caracteres como seus dados se o nível e o valor da palavra-chave corresponderem 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

Cadeia de caracteres para gravar como os dados do evento.

eventLevel
Byte

Nível de detalhes incluídos 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

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

Retornos

Boolean

É true se o evento for gravado; caso contrário, false. Se for falso, chame o GetLastWriteEventError() método 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.

Aplica-se a