如何在Microsoft.Diagnostics.Tracing.EventSource中正确定义关键字?

时间:2016-05-19 10:13:32

标签: c# xml manifest keyword ms-tracing-eventsource

我正在使用Microsoft.Diagnostics.Tracing.EventSource nuget包将事件写入事件日志。在我的自定义类中定义关键字时,继承自EventSource,如下所示:

public class Keywords
{
    public const EventKeywords Page = ( EventKeywords ) 0x1;
    public const EventKeywords DataBase = ( EventKeywords ) 0x2;
    public const EventKeywords Diagnostic = ( EventKeywords ) 0x4;
    public const EventKeywords Perf = ( EventKeywords ) 0x8;
}

我得到一个包含以下xml的清单文件:

<keywords>
    <keyword name="DataBase" message="$(string.keyword_DataBase)" mask="0x1"/>
    <keyword name="Page" message="$(string.keyword_Page)" mask="0x2"/>
    <keyword name="Diagnostic" message="$(string.keyword_Diagnostic)" mask="0x4"/>
    <keyword name="Perf" message="$(string.keyword_Perf)" mask="0x8"/>
    <keyword name="Session3" message="$(string.keyword_Session3)" mask="0x100000000000"/>
    <keyword name="Session2" message="$(string.keyword_Session2)" mask="0x200000000000"/>
    <keyword name="Session1" message="$(string.keyword_Session1)" mask="0x400000000000"/>
    <keyword name="Session0" message="$(string.keyword_Session0)" mask="0x800000000000"/>
</keywords>

我不明白会话关键字的来源。这非常令人讨厌,因为当我使用此代码生成事件时,这些神奇创建的关键字出现在事件日志中:

[Event( 202, Message = "Writing Eventlog With keywords etc. {0}", Level = EventLevel.Verbose, Keywords = Keywords.Perf, Task = EventTask.None, Opcode = EventOpcode.Info, Channel = EventChannel.Debug )]
public void DebugWithKeywordEtc( string message )
{
    this.WriteEvent( 202, message );
}

记录的消息的关键字为Session0,Session1,Session2,Session3,Perf,其源自事件的xml <Keywords>0x4000f08000000000</Keywords>中的关键字值。

我已经自己创作了一个清单文件(使用ecmangen),在该清单中,关键字部分看起来像这样

<keywords>
    <keyword name="DataBase" message="$(string.keyword_DataBase)" mask="0x1"/>
    <keyword name="Page" message="$(string.keyword_Page)" mask="0x2"/>
    <keyword name="Diagnostic" message="$(string.keyword_Diagnostic)" mask="0x4"/>
    <keyword name="Perf" message="$(string.keyword_Perf)" mask="0x8"/>
</keywords>

导致此事件xml:<Keywords>0x8000000000000001</Keywords>。这个结果显示得非常好。

1 个答案:

答案 0 :(得分:0)

EventSource会自动定义和保留这些关键字供自己使用。不幸的是,我不知道如何禁用此行为。