EventSource 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
创建类的新实例 EventSource 。
重载
| 名称 | 说明 |
|---|---|
| EventSource() |
创建类的新实例 EventSource 。 |
| EventSource(Boolean) |
创建 EventSource 类的新实例，并指定在基础Windows代码中发生错误时是否引发异常。 |
| EventSource(EventSourceSettings) |
使用指定的配置设置创建类的新实例 EventSource 。 |
| EventSource(String) |
使用指定名称创建类的新实例 EventSource 。 |
| EventSource(EventSourceSettings, String[]) |
初始化要用于包含指定设置和特征的非协定事件的新实例 EventSource 。 |
| EventSource(String, EventSourceSettings) |
使用指定的名称和设置创建类的新实例 EventSource 。 |
| EventSource(String, Guid) | |
| EventSource(String, EventSourceSettings, String[]) |
使用指定的配置设置创建类的新实例 EventSource 。 |
| EventSource(String, Guid, EventSourceSettings, String[]) |
EventSource()
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
创建类的新实例 EventSource 。
protected:
EventSource();protected EventSource();Protected Sub New ()适用于
EventSource(Boolean)
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
创建 EventSource 类的新实例，并指定在基础Windows代码中发生错误时是否引发异常。
protected:
EventSource(bool throwOnEventWriteErrors);protected EventSource(bool throwOnEventWriteErrors);new System.Diagnostics.Tracing.EventSource : bool -> System.Diagnostics.Tracing.EventSourceProtected Sub New (throwOnEventWriteErrors As Boolean)参数
- throwOnEventWriteErrors
- Boolean
true在基础Windows代码中发生错误时引发异常;否则为 false。
适用于
EventSource(EventSourceSettings)
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- 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.EventSourceProtected Sub New (settings As EventSourceSettings)参数
- settings
- EventSourceSettings
枚举值的按位组合，指定要应用于事件源的配置设置。
注解
通过 settings 指定构造时间 EventSource ，可以指定是以基于清单的格式还是自描述格式写入事件。 此外，还可以指定在事件写入过程中发生错误时应引发异常。
适用于
EventSource(String)
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
使用指定名称创建类的新实例 EventSource 。
public:
EventSource(System::String ^ eventSourceName);public EventSource(string eventSourceName);new System.Diagnostics.Tracing.EventSource : string -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String)参数
- eventSourceName
- String
要应用于事件源的名称。 不得为 null。
例外
eventSourceName 是 null。
注解
使用此构造函数时，请确保 eventSourceName 该参数与该类型的属性定义的 EventSourceAttribute ETW 名称匹配。 否则，属性返回 Guid 的 GUID 和 GetGuid(Type) 方法将有所不同。 如果事件源名称不同，则 Guid 属性返回用于向 ETW 注册此 EventSource 的 GUID。
适用于
EventSource(EventSourceSettings, String[])
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- EventSource.cs
- Source:
- 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.EventSourceProtected Sub New (settings As EventSourceSettings, ParamArray traits As String())参数
- settings
- EventSourceSettings
枚举值的按位组合，指定要应用于事件源的配置设置。
- traits
- String[]
指定事件源特征的键值对。
例外
traits 未在键值对中指定。
注解
特征为事件提供其他信息，并由事件侦听器解释。 特征被指定为键值对，如果未在对中指定，将发生异常。 可以通过将密钥传递给 GetTrait方法来检索特征。
通过 settings 指定构造时间 EventSource ，可以指定是以基于清单的格式还是自描述格式写入事件。 此外，还可以指定在事件写入过程中发生错误时应引发异常。
另请参阅
适用于
EventSource(String, EventSourceSettings)
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- 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.EventSourcePublic Sub New (eventSourceName As String, config As EventSourceSettings)参数
- eventSourceName
- String
要应用于事件源的名称。 不得为 null。
- config
- EventSourceSettings
枚举值的按位组合，指定要应用于事件源的配置设置。
例外
eventSourceName 是 null。
注解
通过 settings 指定构造时间 EventSource ，可以指定是以基于清单的格式还是自描述格式写入事件。 此外，还可以指定在事件写入过程中发生错误时应引发异常。
使用此构造函数时，请确保 eventSourceName 该参数与该类型的属性定义的 EventSourceAttribute ETW 名称匹配。 否则，属性返回 Guid 的 GUID 和 GetGuid(Type) 方法将有所不同。
在这种情况下，该 Guid 属性返回用于向 ETW 注册此 EventSource 的 GUID。
适用于
EventSource(String, Guid)
- Source:
- EventSource.cs
public:
EventSource(System::String ^ eventSourceName, Guid eventSourceGuid);public EventSource(string eventSourceName, Guid eventSourceGuid);new System.Diagnostics.Tracing.EventSource : string * Guid -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String, eventSourceGuid As Guid)参数
- eventSourceName
- String
- eventSourceGuid
- Guid
适用于
EventSource(String, EventSourceSettings, String[])
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- TraceLoggingEventSource.cs
- Source:
- 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.EventSourcePublic 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 该参数与该类型的属性定义的 EventSourceAttribute ETW 名称匹配。 否则，属性返回 Guid 的 GUID 和 GetGuid(Type) 方法将有所不同。
在这种情况下，用于向 ETW 注册此 EventSource 的 GUID 是由 ETW 返回的 GuidGUID。
另请参阅
适用于
EventSource(String, Guid, EventSourceSettings, String[])
- Source:
- EventSource.cs
public EventSource(string eventSourceName, Guid eventSourceGuid, System.Diagnostics.Tracing.EventSourceSettings settings, string[]? traits = default);new System.Diagnostics.Tracing.EventSource : string * Guid * System.Diagnostics.Tracing.EventSourceSettings * string[] -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String, eventSourceGuid As Guid, settings As EventSourceSettings, Optional traits As String() = Nothing)参数
- eventSourceName
- String
- eventSourceGuid
- Guid
- settings
- EventSourceSettings
- traits
- String[]
