TraceSource.TraceEvent 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。

重载

TraceEvent(TraceEventType, Int32)	使用指定的事件类型和事件标识符，将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。
TraceEvent(TraceEventType, Int32, String)	使用指定的事件类型、事件标识符和消息，将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。
TraceEvent(TraceEventType, Int32, String, Object[])	使用指定的事件类型、事件标识符以及自变量数组和格式，将跟踪事件写入 Listeners 集合中的跟踪侦听器中。

TraceEvent(TraceEventType, Int32)

Source:

TraceSource.cs

使用指定的事件类型和事件标识符，将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

参数

eventType

TraceEventType

指定跟踪数据的事件类型的其中一个枚举值。

id

Int32

事件的数值标识符。

属性

ConditionalAttribute

例外

ObjectDisposedException

终止期间尝试跟踪事件。

示例

下面的代码示例演示如何使用 TraceEvent(TraceEventType, Int32) 方法将跟踪事件传递给侦听器。 此代码示例是为 TraceSource 类提供的一个更大示例的一部分。

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

注解

方法 TraceEvent 旨在跟踪可由工具自动处理的事件。 例如，如果特定事件由特定源跟踪，监视工具可以通知管理员。

方法 TraceEvent 调用 ShouldTrace 属性返回的 SourceSwitch 对象的 方法 Switch 。 如果 ShouldTrace 返回 true， TraceEvent 则调用每个侦听器的相应 TraceEvent 方法。 否则， TraceEvent 返回 而不调用侦听器的方法。

跟踪内容特定于侦听器。 如果侦听器实现未重写该方法，则默认输出是跟踪源的名称、其数字标识和事件类型。 其他跟踪内容取决于侦听器的 TraceOutputOptions 属性值。

注意

对象的 EventLogTraceListener 最大值 id 限制为 65,535。 id如果指定的值大于 65,535，则 EventLogTraceListener 使用 65,535。

TraceEvent(TraceEventType, Int32, String)

Source:

TraceSource.cs

使用指定的事件类型、事件标识符和消息，将跟踪事件消息写入 Listeners 集合中的跟踪侦听器中。

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

参数

eventType

TraceEventType

指定跟踪数据的事件类型的其中一个枚举值。

id

Int32

事件的数值标识符。

message

String

要写入的跟踪消息。

属性

ConditionalAttribute

例外

ObjectDisposedException

终止期间尝试跟踪事件。

示例

下面的代码示例演示如何使用 TraceEvent(TraceEventType, Int32) 方法将跟踪事件传递给侦听器。 此代码示例是为 TraceSource 类提供的一个更大示例的一部分。

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");

' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

注解

方法 TraceEvent 旨在跟踪可由工具自动处理的事件。 例如，如果特定事件由特定源跟踪，监视工具可以通知管理员。

方法 TraceEvent 调用 ShouldTrace 属性返回的 SourceSwitch 对象的 方法 Switch 。 如果 ShouldTrace 返回 true， TraceEvent 则调用每个侦听器的相应 TraceEvent 方法。 否则， TraceEvent 返回 而不调用侦听器的方法。

跟踪内容特定于侦听器。 如果侦听器实现未重写方法，则默认输出是跟踪源的名称、其数字标识、事件类型和消息。 其他跟踪内容取决于侦听器的 TraceOutputOptions 属性值。

注意

对象的 EventLogTraceListener 最大值 id 限制为 65,535。 id如果指定的值大于 65,535，则EventLogTraceListener对象使用 65,535。

TraceEvent(TraceEventType, Int32, String, Object[])

Source:

TraceSource.cs

使用指定的事件类型、事件标识符以及自变量数组和格式，将跟踪事件写入 Listeners 集合中的跟踪侦听器中。

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

参数

eventType

TraceEventType

指定跟踪数据的事件类型的其中一个枚举值。

id

Int32

事件的数值标识符。

format

String

包含与零个或多个格式项混合的文本的一个复合格式字符串，与 args 数组中的对象相对应。

args

Object[]

包含零个或多个要格式化的对象的 object 数组。

属性

ConditionalAttribute

例外

ArgumentNullException

format 为 null。

FormatException

format 无效。

- 或 -

表示要设置格式的参数的数字小于零，或者大于等于要设置格式的指定对象的数目。

ObjectDisposedException

终止期间尝试跟踪事件。

示例

下面的代码示例演示如何使用 TraceEvent(TraceEventType, Int32) 方法将跟踪事件传递给侦听器。 此代码示例是为 TraceSource 类提供的一个更大示例的一部分。

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");

' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

注解

有关 参数的详细信息 format ，请参阅 复合格式设置。

方法 TraceEvent 旨在跟踪可由工具自动处理的事件。 例如，如果特定事件由特定源跟踪，监视工具可以通知管理员。

方法 TraceEvent 调用 ShouldTrace 属性返回的 SourceSwitch 对象的 方法 Switch 。 如果 ShouldTrace 返回 true， TraceEvent 则调用每个侦听器的相应 TraceEvent 方法。 否则， TraceEvent 返回 而不调用侦听器的方法。

跟踪内容特定于侦听器。 默认 TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 方法在跟踪标头中写入源名称、事件类型和数字标识，然后调用 String.Format(IFormatProvider, String, Object[]) 方法，传递 format 字符串和 args 数组，并使用 CultureInfo.InvariantCulture 属性将字符串格式化为消息输出。

注意

对象的 EventLogTraceListener 最大值 id 限制为 65,535。 id如果指定的值大于 65,535，则EventLogTraceListener对象使用 65,535。

另请参阅

• 复合格式设置
• 标准数字格式字符串
• 自定义数字格式字符串
• 标准日期/时间格式字符串
• 自定义 DateTime 格式字符串
• Enumeration Format Strings
• 设置 .NET 中类型的格式