TraceSource 建構函式

定義

命名空間:

System.Diagnostics

組件:

netstandard.dll, System.Diagnostics.TraceSource.dll

初始化 TraceSource 類別的新執行個體。

多載

名稱	Description
TraceSource(String)	初始化類別的新實例 TraceSource ，使用指定的來源名稱。
TraceSource(String, SourceLevels)	初始化類別的新實例 TraceSource ，使用指定的來源名稱及追蹤的預設來源層級。

TraceSource(String)

來源:

TraceSource.cs

初始化類別的新實例 TraceSource ，使用指定的來源名稱。

public:
 TraceSource(System::String ^ name);

public TraceSource(string name);

new System.Diagnostics.TraceSource : string -> System.Diagnostics.TraceSource

Public Sub New (name As String)

參數

name

String

來源名稱（通常是應用程式名稱）。

例外狀況

ArgumentNullException

name 是 null。

ArgumentException

name 是空字串（“”）。

範例

以下程式碼範例展示了使用 TraceSource 建構子來建立新 TraceSource 物件的方法。 此程式碼範例是本類別更大範例 TraceSource 的一部分。

// Initialize the trace source.
static TraceSource ts = new TraceSource("TraceTest");

' Initialize the trace source.
Private Shared ts As New TraceSource("TraceTest")

備註

來源名稱用來識別痕跡。 它被用 SourceFilter 來判斷一個追蹤聽取者是否應該產生追蹤。 建議做法是使用應用程式名稱作為來源名稱。

Note

不需要為每個追蹤請求建立新 TraceSource 實例。 建立一個 TraceSource 實例，並用它來處理應用程式的所有追蹤請求。

TraceSource(String, SourceLevels)

來源:

TraceSource.cs

初始化類別的新實例 TraceSource ，使用指定的來源名稱及追蹤的預設來源層級。

public:
 TraceSource(System::String ^ name, System::Diagnostics::SourceLevels defaultLevel);

public TraceSource(string name, System.Diagnostics.SourceLevels defaultLevel);

new System.Diagnostics.TraceSource : string * System.Diagnostics.SourceLevels -> System.Diagnostics.TraceSource

Public Sub New (name As String, defaultLevel As SourceLevels)

參數

name

String

來源名稱，通常是應用程式名稱。

defaultLevel

SourceLevels

一個位元組合的列舉值，指定要追蹤的預設來源層級。

例外狀況

ArgumentNullException

name 是 null。

ArgumentException

name 是空字串（“”）。

備註

來源名稱用來識別痕跡。 它可用於判斷是否要進行追蹤，也可以被 SourceSwitch a SourceFilter 用來判斷是否產生追蹤。 預設的來源層級被 EventTypeFilter 用來判斷是否要根據要追蹤訊息的來源層級進行追蹤。

Note

不需要為每個追蹤請求建立新 TraceSource 實例。 建立一個 TraceSource 實例，並用它來處理應用程式的所有追蹤請求。