TraceListener.TraceData 方法
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
向特定于侦听器的输出中写入跟踪数据。
| 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);C#
public virtual void TraceData (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object? data);C#
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);C#
[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 -> unitPublic 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页眉和页脚中写入 、 sourceeventType 和 id 参数。 参数 data 将编写为跟踪消息的正文。
ToString数据对象的 方法用于将 对象转换为 String。
另请参阅
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- EventLogTraceListener
- TextWriterTraceListener
- Debug
- Trace
适用于
.NET 9 和其他版本
| 产品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- 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);C#
public virtual void TraceData (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);C#
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);C#
[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[] -> unitPublic 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
适用于
.NET 9 和其他版本
| 产品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
