DiagnosticSource.IsEnabled 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.DiagnosticSource.dll

多載

IsEnabled(String)	驗證是否啟用通知事件。
IsEnabled(String, Object, Object)	驗證是否啟用通知事件。

IsEnabled(String)

來源:

DiagnosticSource.cs

驗證是否啟用通知事件。

public:
 abstract bool IsEnabled(System::String ^ name);

public abstract bool IsEnabled (string name);

abstract member IsEnabled : string -> bool

Public MustOverride Function IsEnabled (name As String) As Boolean

參數

name

String

要寫入的事件名稱。

傳回

Boolean

如已啟用通知事件，則為 true；否則為 false。

備註

如果通知有昂貴的設定，您可以在執行此設定之前呼叫 IsEnabled。 取用者不應該假設他們只會收到 IsEnabled 為 true 的通知。 不過，產生者可以選擇性地呼叫此 API。 名稱應該與傳遞至 Write(String, Object)的名稱相同。

IsEnabled(String, Object, Object)

來源:

DiagnosticSource.cs

驗證是否啟用通知事件。

public virtual bool IsEnabled (string name, object? arg1, object? arg2 = default);

abstract member IsEnabled : string * obj * obj -> bool
override this.IsEnabled : string * obj * obj -> bool

Public Overridable Function IsEnabled (name As String, arg1 As Object, Optional arg2 As Object = Nothing) As Boolean

參數

name

String

要寫入的事件名稱。

arg1

Object

物件，表示 IsEnabled 的額外內容。 取用者應會收到 null，這可能表示生產者呼叫了純 IsEnabled(string)，檢查取用者是否想要接到這類事件的通知。 據此，生產者可再次呼叫 IsEnabled(string, object, object) 與非 null 內容。

arg2

Object

選擇性。 物件，表示 IsEnabled 的額外內容。 預設為 null。 取用者應會收到 null，這可能表示生產者呼叫了純 IsEnabled(string) 或生產者在 arg1 中傳遞了所有必要的內容。

傳回

Boolean

如已啟用通知事件，則為 true；否則為 false。

備註

如果通知的安裝成本很高，您可以呼叫此方法，並在執行安裝程式之前提供內容。