TraceListener.TraceData 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
向特定于侦听器的输出中写入跟踪数据。
重载
TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
向特定于侦听器的输出中写入跟踪信息、数据对象和事件信息。 |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
向特定于侦听器的输出中写入跟踪信息、数据对象的数组和事件信息。 |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)
- Source:
- TraceListener.cs
- Source:
- TraceListener.cs
- Source:
- TraceListener.cs
向特定于侦听器的输出中写入跟踪信息、数据对象和事件信息。
public:
virtual void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);
public virtual void TraceData (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object? data);
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
Public Overridable Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, data As Object)
参数
- eventCache
- TraceEventCache
包含当前进程 ID、线程 ID 以及堆栈跟踪信息的 TraceEventCache 对象。
- source
- String
标识输出时使用的名称,通常为生成跟踪事件的应用程序的名称。
- eventType
- TraceEventType
TraceEventType 值之一,指定引发跟踪的事件类型。
- id
- Int32
事件的数值标识符。
- data
- Object
要发出的跟踪数据。
- 属性
注解
重要
此方法不是由应用程序代码直接调用,而是由 、 Trace和 TraceSource 类的成员Debug调用,以便将跟踪数据写入输出。
默认实现在跟踪的eventCache
页眉和页脚中写入 、 source
eventType
和 id
参数。 参数 data
将编写为跟踪消息的正文。 ToString
数据对象的 方法用于将 对象转换为 String。
另请参阅
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- EventLogTraceListener
- TextWriterTraceListener
- Debug
- Trace
适用于
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])
- Source:
- TraceListener.cs
- Source:
- TraceListener.cs
- Source:
- TraceListener.cs
向特定于侦听器的输出中写入跟踪信息、数据对象的数组和事件信息。
public:
virtual void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);
public virtual void TraceData (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
Public Overridable Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, ParamArray data As Object())
参数
- eventCache
- TraceEventCache
包含当前进程 ID、线程 ID 以及堆栈跟踪信息的 TraceEventCache 对象。
- source
- String
标识输出时使用的名称,通常为生成跟踪事件的应用程序的名称。
- eventType
- TraceEventType
TraceEventType 值之一,指定引发跟踪的事件类型。
- id
- Int32
事件的数值标识符。
- data
- Object[]
要作为数据发出的对象数组。
- 属性
注解
重要
此方法不是由应用程序代码直接调用,而是由 、 Trace和 TraceSource 类的成员Debug调用,以便将跟踪数据写入输出。
默认实现将 、 eventType
和 id
参数的值source
写入标头。 使用 ToString
每个 对象的 方法将数据对象转换为字符串。 数据 eventCache
以页脚的形式写入,输出数据的性质依赖于 属性的值 TraceOutputOptions 。
另请参阅
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- EventLogTraceListener
- TextWriterTraceListener
- Debug
- Trace