EventProvider.WriteMessageEvent Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Escreve um evento que contém uma string como seu dado.
Sobrecargas
| Name | Description |
|---|---|
| WriteMessageEvent(String) |
Escreve um evento que contém uma string como seu dado. |
| WriteMessageEvent(String, Byte, Int64) |
Escreve um evento que contém uma cadeia como dado se o valor de nível e palavra-chave corresponder aos eventos solicitados pela sessão. |
Observações
Estes métodos não requerem um manifesto para consumir o evento.
WriteMessageEvent(String)
Escreve um evento que contém uma string como seu dado.
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
Faz uma string para escrever como os dados do evento.
Devoluções
É true se o evento for escrito; caso contrário, false. Se for falso, chama o GetLastWriteEventError() método para determinar a causa da falha.
Exceções
Se eventMessage for null.
Exemplos
if (!provider.WriteMessageEvent("Event string."))
Console.WriteLine(EventProvider.GetLastWriteEventError());
Observações
O comprimento máximo da string é limitado a 64 KB menos o tamanho dos cabeçalhos dos eventos. O tamanho do evento é menor se o 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)
Escreve um evento que contém uma cadeia como dado se o valor de nível e palavra-chave corresponder 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 -> boolPublic Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As BooleanParâmetros
- eventMessage
- String
Faz uma string para escrever como os dados do evento.
- eventLevel
- Byte
Nível de detalhe incluído no evento. Se o fornecedor 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 do evento. Se o fornecedor usar um manifesto para definir o evento, defina esse valor para a mesma máscara de palavras-chave definida no manifesto.
Devoluções
É true se o evento for escrito; caso contrário, false. Se for falso, chama o GetLastWriteEventError() método para determinar a causa da falha.
- Atributos
Exceções
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());
Observações
O comprimento máximo da string é limitado a 64 KB menos o tamanho dos cabeçalhos dos eventos. O tamanho do evento é menor se o buffer da sessão for menor e a sessão incluir itens de dados estendidos com o evento.
