TraceListener.TraceEvent 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

向特定于侦听器的输出写入跟踪和事件信息。

重载

TraceEvent(TraceEventCache, String, TraceEventType, Int32)	向特定于侦听器的输出写入跟踪和事件信息。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	向特定于侦听器的输出中写入跟踪信息、消息和事件信息。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	向特定于侦听器的输出中写入跟踪信息、格式化对象数组和事件信息。

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Source:

TraceListener.cs

向特定于侦听器的输出写入跟踪和事件信息。

public:
 virtual void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id);

public virtual void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id);

abstract member TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int -> unit
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int -> unit

Public Overridable Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer)

参数

eventCache

TraceEventCache

包含当前进程 ID、线程 ID 以及堆栈跟踪信息的 TraceEventCache 对象。

source

String

标识输出时使用的名称，通常为生成跟踪事件的应用程序的名称。

eventType

TraceEventType

TraceEventType 值之一，指定引发跟踪的事件类型。

id

Int32

事件的数值标识符。

注解

重要

此方法不是由应用程序代码直接调用，而是由 、 Trace和 TraceSource 类的成员Debug调用，以将跟踪数据写入输出。

默认实现将 和 eventTypeid 参数的值source写入标头。 数据 eventCache 以页脚形式写入，输出数据的性质取决于 属性的值 TraceOutputOptions 。

另请参阅

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Source:

TraceListener.cs

向特定于侦听器的输出中写入跟踪信息、消息和事件信息。

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

public virtual void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? message);

abstract member TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overridable Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)

参数

eventCache

TraceEventCache

包含当前进程 ID、线程 ID 以及堆栈跟踪信息的 TraceEventCache 对象。

source

String

标识输出时使用的名称，通常为生成跟踪事件的应用程序的名称。

eventType

TraceEventType

TraceEventType 值之一，指定引发跟踪的事件类型。

id

Int32

事件的数值标识符。

message

String

要写入的消息。

注解

重要

此方法不是由应用程序代码直接调用，而是由 、 Trace和 TraceSource 类的成员Debug调用，以将跟踪数据写入输出。

默认实现将 和 eventTypeid 参数的值source写入为标头，后跟message数据。 数据 eventCache 以页脚形式写入，输出数据的性质取决于 属性的值 TraceOutputOptions 。

另请参阅

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace

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

Source:

TraceListener.cs

向特定于侦听器的输出中写入跟踪信息、格式化对象数组和事件信息。

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

public virtual void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

abstract member TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

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

参数

eventCache

TraceEventCache

包含当前进程 ID、线程 ID 以及堆栈跟踪信息的 TraceEventCache 对象。

source

String

标识输出时使用的名称，通常为生成跟踪事件的应用程序的名称。

eventType

TraceEventType

TraceEventType 值之一，指定引发跟踪的事件类型。

id

Int32

事件的数值标识符。

format

String

一个格式字符串，其中包含零个或多个格式项，它们对应于 args 数组中的对象。

args

Object[]

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

注解

重要

此方法不是由应用程序代码直接调用，而是由 、 Trace和 TraceSource 类的成员Debug调用，以将跟踪数据写入输出。

默认实现将 和 eventTypeid 参数的值source写入标头。 对象 args 数组使用 Format 方法转换为字符串，传递 format 字符串和 args 数组以将字符串格式化为跟踪的消息部分。 数据 eventCache 以页脚形式写入，输出数据的性质取决于 属性的值 TraceOutputOptions 。

另请参阅

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace