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

如果 eventMessagenull。

示例

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

如果 eventMessagenull。

示例

// 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，减去事件标头的大小。 如果会话的缓冲区大小较小，并且会话包含事件的扩展数据项，则事件大小会减少。