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 しいインスタンスを作成する必要はありません。 1 つのTraceSourceインスタンスをCreateし、アプリケーションのすべてのトレース要求に使用します。

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 しいインスタンスを作成する必要はありません。 1 つのTraceSourceインスタンスをCreateし、アプリケーションのすべてのトレース要求に使用します。