TraceSource 构造函数

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

初始化 TraceSource 类的新实例。

重载

TraceSource(String)	使用指定的源名称初始化 TraceSource 类的新实例。
TraceSource(String, SourceLevels)	使用源的指定名称和执行跟踪的默认源级别初始化 TraceSource 类的新实例。

TraceSource(String)

Source:

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)

Source:

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实例，并将其用于应用程序的所有跟踪请求。