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

适用于