EventSource 建構函式

定義

命名空間:: System.Diagnostics.Tracing

組件:: mscorlib.dll, System.Diagnostics.Tracing.dll

組件:: netstandard.dll, System.Diagnostics.Tracing.dll

組件:: System.Diagnostics.Tracing.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

建立一個新的類別實例 EventSource 。

多載

名稱	Description
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()

來源:: EventSource.cs

來源:: EventSource.cs

來源:: EventSource.cs

來源:: EventSource.cs

來源:: EventSource.cs

建立一個新的類別實例 EventSource 。

protected:
 EventSource();

protected EventSource();

Protected Sub New ()

適用於

EventSource(Boolean)

來源:: EventSource.cs

來源:: EventSource.cs

來源:: 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.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

來源:: 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。

例外狀況

ArgumentNullException

eventSourceName 是 null。

備註

使用此建構子時，請確保參數 eventSourceName 與該型別屬性所定義 EventSourceAttribute 的 ETW 名稱相符。否則，屬性Guid回傳GetGuid(Type)的 GUID 和方法會不同。若事件來源名稱不同，該 Guid 屬性會回傳用於向 ETW 註冊此事件源的 GUID。

適用於

EventSource(EventSourceSettings, String[])

來源:: EventSource.cs

來源:: EventSource.cs

來源:: 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[]

指定事件來源特徵的鍵值對。

例外狀況

ArgumentException

traits 不以鍵值對指定。

備註

特徵提供事件的額外資訊，並由事件聆聽者詮釋。特徵以鍵值對形式指定，若未成對指定，將發生例外。你可以透過傳遞，方法的金鑰 GetTrait來取得特徵。

另請參閱

GetTrait(String)

適用於

EventSource(String, EventSourceSettings)

來源:: TraceLoggingEventSource.cs

來源:: TraceLoggingEventSource.cs

來源:: 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

以位元組合列出的列舉值，指定要套用到事件來源的設定設定。

例外狀況

ArgumentNullException

eventSourceName 是 null。

備註

使用此建構子時，請確保參數 eventSourceName 與該型別屬性所定義 EventSourceAttribute 的 ETW 名稱相符。否則，屬性Guid回傳GetGuid(Type)的 GUID 和方法會不同。

在這種情況下，屬性 Guid 會回傳用來向 ETW 註冊該事件源的 GUID。

適用於

EventSource(String, Guid)

來源:: 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.EventSource

Public Sub New (eventSourceName As String, eventSourceGuid As Guid)

參數

eventSourceName: String

eventSourceGuid: Guid

適用於

EventSource(String, EventSourceSettings, String[])

來源:: TraceLoggingEventSource.cs

來源:: TraceLoggingEventSource.cs

來源:: 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[]

指定事件來源特徵的鍵值對。

例外狀況

ArgumentNullException

eventSourceName 是 null。

ArgumentException

traits 不以鍵值對指定。

備註

指定 config 何時 EventSource 建構事件，可以讓你判斷事件是以以清單式還是自我描述格式撰寫。此外，你可以指定在事件寫入過程中發生錯誤時應提出例外。

使用此建構子時，請確保參數 eventSourceName 與該型別屬性所定義 EventSourceAttribute 的 ETW 名稱相符。否則，屬性Guid回傳GetGuid(Type)的 GUID 和方法會不同。

在這種情況下，用來向 ETW 註冊此事件源的 GUID 就是。Guid

另請參閱

GetTrait(String)

適用於

EventSource(String, Guid, EventSourceSettings, String[])

來源:: 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.EventSource

Public Sub New (eventSourceName As String, eventSourceGuid As Guid, settings As EventSourceSettings, Optional traits As String() = Nothing)

參數

eventSourceName: String

eventSourceGuid: Guid

settings: EventSourceSettings

traits: String[]

適用於

意見反應

此頁面對您有幫助嗎？