DiagnosticSource.IsEnabled 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.DiagnosticSource.dll

重载

IsEnabled(String)	验证通知事件是否已启用。
IsEnabled(String, Object, Object)	验证通知事件是否已启用。

IsEnabled(String)

Source:

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)

Source:

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) 来检查使用者是否确实要获取此类事件的通知。 基于此，生成方可使用非 null 上下文再次调用 IsEnabled(string, object, object)。

arg2

Object

可选。 一个对象，它表示 IsEnabled 的附加上下文。 默认值为 null。 使用者应会收到 null，它可能表示生成方已调用纯 IsEnabled(string) 或者已在 arg1 中传递所有必要的上下文。

返回

Boolean

如果通知事件已启用，为 true；否则为 false。

注解

如果通知设置成本高昂，则可以调用此方法并在执行设置之前提供上下文。