Microsoft Semantic Logging——使用WriteEvent和IsEnabled函数

每个事件都使用一个方法来定义，该方法封装了事件源类中对WriteEvent方法的调用。WriteEvent方法的第一个参数是事件标识符，它在事件源中必须是唯一的。此方法的不同重载版本(必须使用不同的事件标识符)使您能够将其他信息写入日志。

注意：

如果希望关联异步任务引发的事件和应用程序生成的新线程，则必须在事件源而不是WriteEvent方法中使用WriteEventWithRelatedActivityId方法发布传输事件。有关更多信息，请参见相关事件。

在示例MyCompanyEventSource类中，PageStart等方法包括对基类中的IsEnable方法的调用，以确定是否写入日志消息。如果您正在使用包含对象数组参数的WriteEvent方法的昂贵重载，则IsEnable方法有助于提高性能。

如果需要，可以在事件源类中的Helper方法中调用IsEnable方法。例如，未定义为事件但在调用事件方法之前执行某些数据预处理、转换或格式化的方法，如果未启用事件，则可能不需要执行。

IsEnable方法的重载可用，可以检查是否为特定的关键字和级别启用了事件源。但是，在这种重载的情况下，确保IsEnable方法的参数与EventAttribute属性中的关键字和级别匹配是很重要的。

有关事件源类以及WriteEvent和IsEnable方法的详细信息，请参阅MSDN上的事件源类。