EventProvider.WriteMessageEvent 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
写入一个包含字符串数据的事件。
重载
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
要作为事件数据写入的字符串。
返回
如果写入此事件,则为 true
;否则为 false
。 如果为 false,则调用 GetLastWriteEventError() 方法来确定失败的原因。
例外
如果 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
指定事件类别的位掩码。 如果提供程序使用某个清单来定义该事件,请将此值设置为在该清单中定义的关键字掩码。
返回
如果写入此事件,则为 true
;否则为 false
。 如果为 false,则调用 GetLastWriteEventError() 方法来确定失败的原因。
- 属性
例外
如果 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 减去事件标头的大小。 如果会话的缓冲区较小,而且会话中包括事件的扩展数据项,则该事件会较小。