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.

Комментарии

Если для уведомления требуется много ресурсов, можно вызвать этот метод и указать контекст перед выполнением настройки.