EventProvider.WriteMessageEvent 方法

定义

命名空间:

System.Diagnostics.Eventing

程序集:

System.Core.dll

写入一个包含字符串数据的事件。

重载

WriteMessageEvent(String)	写入一个包含字符串数据的事件。
WriteMessageEvent(String, Byte, Int64)	如果级别值和关键字值与该会话所请求的事件相匹配，则写入一个包含字符串数据的事件。

注解

这些方法不需要清单即可使用 事件。

WriteMessageEvent(String)

写入一个包含字符串数据的事件。

public:
 bool WriteMessageEvent(System::String ^ eventMessage);

public bool WriteMessageEvent (string eventMessage);

member this.WriteMessageEvent : string -> bool

Public Function WriteMessageEvent (eventMessage As String) As Boolean

参数

eventMessage

String

要作为事件数据写入的字符串。

返回

Boolean

如果写入此事件，则为 true；否则为 false。 如果为 false，则调用 GetLastWriteEventError() 方法来确定失败的原因。

例外

ArgumentException

如果 eventMessage 为 null。

示例

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

注解

最大字符串长度限制为 64 KB 减去事件标头的大小。 如果会话的缓冲区较小，而且会话中包括事件的扩展数据项，则该事件会较小。

WriteMessageEvent(String, Byte, Int64)

如果级别值和关键字值与该会话所请求的事件相匹配，则写入一个包含字符串数据的事件。

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

参数

eventMessage

String

要作为事件数据写入的字符串。

eventLevel

Byte

包括在该事件中的详细程度。 如果提供程序使用某个清单来定义该事件，请将此值设置为该清单中定义的级别。

eventKeywords

Int64

指定事件类别的位掩码。 如果提供程序使用某个清单来定义该事件，请将此值设置为在该清单中定义的关键字掩码。

返回

Boolean

如果写入此事件，则为 true；否则为 false。 如果为 false，则调用 GetLastWriteEventError() 方法来确定失败的原因。

属性

SecurityCriticalAttribute

例外

ArgumentException

如果 eventMessage 为 null。

示例

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

注解

最大字符串长度限制为 64 KB 减去事件标头的大小。 如果会话的缓冲区较小，而且会话中包括事件的扩展数据项，则该事件会较小。