TraceSource 建構函式

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

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

多載

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 用來判斷追蹤接聽程式是否應該產生追蹤。 建議的做法是針對來源名稱使用應用程式的名稱。

注意

不需要為每個追蹤要求建立新的 TraceSource 實例。 Create 一個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 判斷追蹤是否要發生，以及 SourceFilter 用來判斷是否要產生追蹤。 默認來源層級是 EventTypeFilter 用來判斷是否要根據要追蹤之訊息的來源層級進行追蹤。

注意

不需要為每個追蹤要求建立新的 TraceSource 實例。 Create 一個TraceSource實例，並將它用於應用程式的所有追蹤要求。