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 會判斷事件是否記錄到會話。 如果提供者需要執行額外的工作來產生事件，提供者可能會想要呼叫此函式。 在此情況下，先呼叫此函式可能會節省資源和時間。