FileLogTraceListener.TraceData 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
向输出文件写入跟踪数据。
重载
TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
向输出文件或流中写入跟踪信息、数据对象和事件信息。 |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
将跟踪信息、数据对象数组和事件信息写入输出文件或流中。 |
注解
TraceData 方法不应由应用程序代码调用。 这些方法由 、 Trace和 TraceSource 类的成员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
要发出的跟踪数据。
注解
此方法:
设置输出的数据和上下文信息的格式。
如有必要,创建新的日志文件。
将信息写入日志文件。
有关创建新日志文件的详细信息,请参阅 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[]
要作为数据发出的对象数组。
注解
此方法:
设置输出的数据和上下文信息的格式,
如有必要,创建新的日志文件,
将信息写入日志文件。
有关创建新日志文件的详细信息,请参阅 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 时。 |
计算机的名称。 |