TraceSource.TraceData 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

将跟踪数据写入 Listeners 集合中的跟踪侦听器中。

重载

TraceData(TraceEventType, Int32, Object)	使用指定的事件类型、事件标识符和跟踪数据，将跟踪数据写入 Listeners 集合中的跟踪侦听器中。
TraceData(TraceEventType, Int32, Object[])	使用指定的事件类型、事件标识符和跟踪数据数组，将跟踪数据写入 Listeners 集合中的跟踪侦听器中。

TraceData(TraceEventType, Int32, Object)

Source:

TraceSource.cs

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

public:
 void TraceData(System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);

[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, object? data);

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

Public Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)

参数

eventType

TraceEventType

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

id

Int32

事件的数值标识符。

data

Object

跟踪数据。

属性

ConditionalAttribute

例外

ObjectDisposedException

终止期间尝试跟踪事件。

示例

下面的代码示例演示如何使用 TraceData(TraceEventType, Int32, Object) 方法筛选跟踪消息并将其转发到侦听器。 此代码示例是为 TraceSource 类提供的一个更大示例的一部分。

// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
    "SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
    "SourceFilter should let this message through on the console trace listener.");

' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")

注解

与 TraceData 方法一样 TraceEvent ， 方法适用于自动化工具，但它还允许将其他对象（如异常实例）附加到跟踪。

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

注意

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

TraceData(TraceEventType, Int32, Object[])

Source:

TraceSource.cs

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

public:
 void TraceData(System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);

[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);

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

Public Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())

参数

eventType

TraceEventType

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

id

Int32

事件的数值标识符。

data

Object[]

包含跟踪数据的对象数组。

属性

ConditionalAttribute

例外

ObjectDisposedException

终止期间尝试跟踪事件。

注解

与 方法一样TraceEvent，该方法TraceData适用于自动化工具，但它还允许将其他对象（如异常实例和堆栈跟踪）附加到跟踪。

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

注意

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