Share via


FileLogTraceListener.TraceData 方法

定义

向输出文件写入跟踪数据。

重载

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

向输出文件或流中写入跟踪信息、数据对象和事件信息。

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

将跟踪信息、数据对象数组和事件信息写入输出文件或流中。

注解

TraceData 方法不应由应用程序代码调用。 这些方法由 、 TraceTraceSource 类的成员Debug调用,以将跟踪数据写入输出。

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

向输出文件或流中写入跟踪信息、数据对象和事件信息。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
Public Overrides 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

要发出的跟踪数据。

注解

此方法:

  1. 设置输出的数据和上下文信息的格式。

  2. 如有必要,创建新的日志文件。

  3. 将信息写入日志文件。

有关创建新日志文件的详细信息,请参阅 FullLogFileName

下表列出了输出字段的显示顺序。 字段由 属性指定的字符串 Delimiter 分隔,后跟行终止符。

字段 输出条件 描述
source 始终 name 的值。
severity 始终 的枚举值名称 eventType
id 始终 id 的字符串表示形式。
message 始终 data 的字符串表示形式。
callStack Callstack在 属性中TraceOutputOptions设置 标志时。 CallstackeventCache属性。
CorrelationID LogicalOperationStack在 属性中TraceOutputOptions设置 标志时。 ThreadIdeventCache属性。
DateTime DateTime在 属性中TraceOutputOptions设置 标志时。 的 属性的DateTimeeventCache字符串表示形式。 固定区域性用于字符串转换。
ProcessID ProcessId在 属性中TraceOutputOptions设置 标志时。 的 属性的ProcessIdeventCache字符串表示形式。 固定区域性用于字符串转换。
ThreadID ThreadId在 属性中TraceOutputOptions设置 标志时。 ThreadIdeventCache属性。
Timestamp Timestamp在 属性中TraceOutputOptions设置 标志时。 的 属性的TimestampeventCache字符串表示形式。 固定区域性用于字符串转换。
HostName IncludeHostName当 属性为 True时。 计算机的名称。

另请参阅

适用于

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

将跟踪信息、数据对象数组和事件信息写入输出文件或流中。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
Public Overrides 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[]

要作为数据发出的对象数组。

注解

此方法:

  1. 设置输出的数据和上下文信息的格式,

  2. 如有必要,创建新的日志文件,

  3. 将信息写入日志文件。

有关创建新日志文件的详细信息,请参阅 FullLogFileName

此表列出了输出字段的显示顺序。 字段由 属性指定的字符串 Delimiter 分隔,后跟行终止符。

字段 输出条件 描述
source 始终 name 的值。
severity 始终 的枚举值名称 eventType
id 始终 id 的字符串表示形式。
message 始终 由 中 data每个元素的字符串表示形式组成的字符串,每个元素由 Delimiter分隔。
callStack Callstack在 属性中TraceOutputOptions设置 标志时。 CallstackeventCache属性。
CorrelationID LogicalOperationStack在 属性中TraceOutputOptions设置 标志时。 ThreadIdeventCache属性。
DateTime DateTime在 属性中TraceOutputOptions设置 标志时。 的 属性的DateTimeeventCache字符串表示形式。 固定区域性用于字符串转换。
ProcessID ProcessId在 属性中TraceOutputOptions设置 标志时。 的 属性的ProcessIdeventCache字符串表示形式。 固定区域性用于字符串转换。
ThreadID ThreadId在 属性中TraceOutputOptions设置 标志时。 ThreadIdeventCache属性。
Timestamp Timestamp在 属性中TraceOutputOptions设置 标志时。 的 属性的TimestampeventCache字符串表示形式。 固定区域性用于字符串转换。
HostName IncludeHostName当 属性为 True时。 计算机的名称。

另请参阅

适用于