Поделиться через


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

Определение

Создает новый экземпляр класса 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.cs
Исходный код:
EventSource.cs

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

protected:
 EventSource();
protected EventSource ();
Protected Sub New ()

Применяется к

EventSource(Boolean)

Исходный код:
EventSource.cs
Исходный код:
EventSource.cs
Исходный код:
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.cs
Исходный код:
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
Исходный код:
TraceLoggingEventSource.cs
Исходный код:
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.

Исключения

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

Комментарии

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

Применяется к

EventSource(EventSourceSettings, String[])

Исходный код:
EventSource.cs
Исходный код:
EventSource.cs
Исходный код:
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);
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[]

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

Исключения

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

Комментарии

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

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

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

Применяется к

EventSource(String, EventSourceSettings)

Исходный код:
TraceLoggingEventSource.cs
Исходный код:
TraceLoggingEventSource.cs
Исходный код:
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

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

Исключения

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

Комментарии

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

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

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

Применяется к

EventSource(String, EventSourceSettings, String[])

Исходный код:
TraceLoggingEventSource.cs
Исходный код:
TraceLoggingEventSource.cs
Исходный код:
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);
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[]

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

Исключения

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

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

Комментарии

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

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

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

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

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

Применяется к