EventSource Конструкторы

Определение

Пространство имен:

System.Diagnostics.Tracing

Сборка:

System.Diagnostics.Tracing.dll

Создает новый экземпляр класса EventSource.

Перегрузки

EventSource()	Создает новый экземпляр класса EventSource.
EventSource(Boolean)	Создает экземпляр класса EventSource и определяет, следует ли создавать исключение при возникновении ошибки в базовом коде Windows.
EventSource(EventSourceSettings)	Создает экземпляр класса EventSource с указанными параметрами конфигурации.
EventSource(String)	Создает экземпляр класса EventSource с указанным именем.
EventSource(EventSourceSettings, String[])	Инициализирует новый экземпляр класса EventSource для использования с неконтрактными событиями, который содержит указанные параметры и признаки.
EventSource(String, EventSourceSettings)	Создает экземпляр класса EventSource с указанным именем и параметрами.
EventSource(String, EventSourceSettings, String[])	Создает экземпляр класса EventSource с указанными параметрами конфигурации.

EventSource()

Исходный код:

EventSource.cs

Создает новый экземпляр класса EventSource.

protected:
 EventSource();

protected EventSource ();

Protected Sub New ()

EventSource(Boolean)

Исходный код:

EventSource.cs

Создает экземпляр класса EventSource и определяет, следует ли создавать исключение при возникновении ошибки в базовом коде Windows.

protected:
 EventSource(bool throwOnEventWriteErrors);

protected EventSource (bool throwOnEventWriteErrors);

new System.Diagnostics.Tracing.EventSource : bool -> System.Diagnostics.Tracing.EventSource

Protected Sub New (throwOnEventWriteErrors As Boolean)

Параметры

throwOnEventWriteErrors

Boolean

Значение true для создания исключения при возникновении ошибки в базовом коде Windows; в противном случае — значение false.

EventSource(EventSourceSettings)

Исходный код:

EventSource.cs

Создает экземпляр класса EventSource с указанными параметрами конфигурации.

protected:
 EventSource(System::Diagnostics::Tracing::EventSourceSettings settings);

protected EventSource (System.Diagnostics.Tracing.EventSourceSettings settings);

new System.Diagnostics.Tracing.EventSource : System.Diagnostics.Tracing.EventSourceSettings -> System.Diagnostics.Tracing.EventSource

Protected Sub New (settings As EventSourceSettings)

Параметры

settings

EventSourceSettings

Побитовое сочетание значений перечисления, которое определяет параметры конфигурации, применяемые к источнику события.

Комментарии

Указание settings времени EventSource создания позволяет указать, записывается ли событие в формате на основе манифеста или в самоописающем формате. Кроме того, можно указать, что исключение должно вызываться при возникновении ошибки во время процесса записи событий.

EventSource(String)

Исходный код:

TraceLoggingEventSource.cs

Создает экземпляр класса EventSource с указанным именем.

public:
 EventSource(System::String ^ eventSourceName);

public EventSource (string eventSourceName);

new System.Diagnostics.Tracing.EventSource : string -> System.Diagnostics.Tracing.EventSource

Public Sub New (eventSourceName As String)

Параметры

eventSourceName

String

Имя, назначаемое источнику событий. Значение не должно быть равно null.

Исключения

ArgumentNullException

eventSourceName имеет значение null.

Комментарии

При использовании этого конструктора eventSourceName убедитесь, что аргумент соответствует имени трассировки событий Windows, определенному атрибутом EventSourceAttribute для этого типа. В противном случае идентификаторы GUID, возвращаемые свойством Guid и методом GetGuid(Type) , будут отличаться. Если имена источников событий отличаются, свойство возвращает ИДЕНТИФИКАТОР GUID, Guid используемый для регистрации этого EventSource в трассировки событий Windows.

EventSource(EventSourceSettings, String[])

Исходный код:

EventSource.cs

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

protected:
 EventSource(System::Diagnostics::Tracing::EventSourceSettings settings, ... cli::array <System::String ^> ^ traits);

protected EventSource (System.Diagnostics.Tracing.EventSourceSettings settings, params string[]? traits);

new System.Diagnostics.Tracing.EventSource : System.Diagnostics.Tracing.EventSourceSettings * string[] -> System.Diagnostics.Tracing.EventSource

Protected Sub New (settings As EventSourceSettings, ParamArray traits As String())

Параметры

settings

EventSourceSettings

Побитовое сочетание значений перечисления, которое определяет параметры конфигурации, применяемые к источнику события.

traits

String[]

Пары ключ-значение, определяющие признаки для источника события.

Исключения

ArgumentException

traits не указан в парах "ключ значение".

Комментарии

Признаки предоставляют дополнительные сведения для события и интерпретируются прослушивателем событий. Признаки указываются как пары "ключ-значение", и если они не указаны в парах, возникнет исключение. Признак можно получить, передав ключ в GetTraitметод , .

Указание settings времени EventSource создания позволяет указать, записывается ли событие в формате на основе манифеста или в самоописающем формате. Кроме того, можно указать, что исключение должно вызываться при возникновении ошибки во время процесса записи событий.

См. также раздел

• GetTrait(String)

EventSource(String, EventSourceSettings)

Исходный код:

TraceLoggingEventSource.cs

Создает экземпляр класса EventSource с указанным именем и параметрами.

public:
 EventSource(System::String ^ eventSourceName, System::Diagnostics::Tracing::EventSourceSettings config);

public EventSource (string eventSourceName, System.Diagnostics.Tracing.EventSourceSettings config);

new System.Diagnostics.Tracing.EventSource : string * System.Diagnostics.Tracing.EventSourceSettings -> System.Diagnostics.Tracing.EventSource

Public Sub New (eventSourceName As String, config As EventSourceSettings)

Параметры

eventSourceName

String

Имя, назначаемое источнику событий. Значение не должно быть равно null.

config

EventSourceSettings

Побитовое сочетание значений перечисления, которое определяет параметры конфигурации, применяемые к источнику события.

Исключения

ArgumentNullException

eventSourceName имеет значение null.

Комментарии

Указание settings времени EventSource создания позволяет указать, записывается ли событие в формате на основе манифеста или в самоописающем формате. Кроме того, можно указать, что исключение должно вызываться при возникновении ошибки во время процесса записи событий.

При использовании этого конструктора eventSourceName убедитесь, что аргумент соответствует имени трассировки событий Windows, определенному атрибутом EventSourceAttribute для этого типа. В противном случае идентификаторы GUID, возвращаемые свойством Guid и методом GetGuid(Type) , будут отличаться.

В таких случаях свойство возвращает ИДЕНТИФИКАТОР GUID, Guid используемый для регистрации этого EventSource в ETW.

EventSource(String, EventSourceSettings, String[])

Исходный код:

TraceLoggingEventSource.cs

Создает экземпляр класса EventSource с указанными параметрами конфигурации.

public:
 EventSource(System::String ^ eventSourceName, System::Diagnostics::Tracing::EventSourceSettings config, ... cli::array <System::String ^> ^ traits);

public EventSource (string eventSourceName, System.Diagnostics.Tracing.EventSourceSettings config, params string[]? traits);

new System.Diagnostics.Tracing.EventSource : string * System.Diagnostics.Tracing.EventSourceSettings * string[] -> System.Diagnostics.Tracing.EventSource

Public Sub New (eventSourceName As String, config As EventSourceSettings, ParamArray traits As String())

Параметры

eventSourceName

String

Имя, назначаемое источнику событий. Значение не должно быть равно null.

config

EventSourceSettings

Побитовое сочетание значений перечисления, которое определяет параметры конфигурации, применяемые к источнику события.

traits

String[]

Пары ключ-значение, определяющие признаки для источника события.

Исключения

ArgumentNullException

eventSourceName имеет значение null.

ArgumentException

traits не указан в парах "ключ значение".

Комментарии

Признаки предоставляют дополнительные сведения для события и интерпретируются прослушивателем событий. Признаки указываются как пары "ключ-значение", и если они не указаны в парах, возникнет исключение. Признак можно получить, передав ключ в GetTraitметод , .

Указание config времени EventSource создания позволяет указать, записывается ли событие в формате на основе манифеста или в самоописающем формате. Кроме того, можно указать, что исключение должно вызываться при возникновении ошибки во время процесса записи событий.

При использовании этого конструктора eventSourceName убедитесь, что аргумент соответствует имени трассировки событий Windows, определенному атрибутом EventSourceAttribute для этого типа. В противном случае идентификаторы GUID, возвращаемые свойством Guid и методом GetGuid(Type) , будут отличаться.

В таких случаях guid, используемый для регистрации этого EventSource в etw, возвращается Guid.

См. также раздел

• GetTrait(String)