EventProvider.IsEnabled 方法

定义

命名空间:

System.Diagnostics.Eventing

程序集:

System.Core.dll

确定该提供程序是否已经由某个会话启用。

重载

IsEnabled(Byte, Int64)	确认是否有任何会话正在从该提供程序请求指定的事件。
IsEnabled()	确定该提供程序是否已经由某个会话启用，而与用来启用该提供程序的级别值和关键字值无关。

IsEnabled(Byte, Int64)

确认是否有任何会话正在从该提供程序请求指定的事件。

public:
 bool IsEnabled(System::Byte level, long keywords);

public bool IsEnabled (byte level, long keywords);

member this.IsEnabled : byte * int64 -> bool

Public Function IsEnabled (level As Byte, keywords As Long) As Boolean

参数

level

Byte

包括在该事件中的详细程度。

keywords

Int64

指定事件类别的位掩码。 此掩码应当与在该事件的清单中定义的关键字掩码相同。

返回

Boolean

如果有任何会话正在请求指定的事件，则为 true；否则为 false。

注解

通常，提供程序不会调用此方法来确定会话是否请求了指定的事件;提供程序只需写入事件，ETW 将确定是否将事件记录到会话中。 如果提供程序需要执行额外的工作来生成事件，则提供程序可能需要调用此函数。 在这种情况下，首先调用此函数以确定会话是否请求了事件，可以节省资源和时间。

IsEnabled()

确定该提供程序是否已经由某个会话启用，而与用来启用该提供程序的级别值和关键字值无关。

public:
 bool IsEnabled();

public bool IsEnabled ();

member this.IsEnabled : unit -> bool

Public Function IsEnabled () As Boolean

返回

Boolean

如果已为某个会话启用该提供程序，则为 true；否则为 false。

注解

通常，提供程序不会调用此方法来确定会话是否启用了提供程序;提供程序只需写入事件，ETW 将确定是否将事件记录到会话中。 如果提供程序需要执行额外的工作来生成事件，则提供程序可能需要调用此函数。 在这种情况下，首先调用此函数可能会节省资源和时间。