通过

FileLogTraceListener.TraceEvent 方法

  • 参考

定义

命名空间:
Microsoft.VisualBasic.Logging
程序集:
Microsoft.VisualBasic.dll
程序集:
Microsoft.VisualBasic.Forms.dll

向输出文件或流中写入跟踪信息和事件信息。

重载

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

将跟踪信息、消息和事件信息写入输出文件或流中。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

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

注解

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

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

将跟踪信息、消息和事件信息写入输出文件或流中。

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

要写入的消息。

注解

此方法：

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

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

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

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

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

字段 输出条件 描述
source 始终。 name 的值。
severity 始终。 的枚举值名称 eventType。
id 始终。 id 的字符串表示形式。
message 始终。 message 的值。
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时。 计算机的名称。

另请参阅

适用于

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

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

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

注解

此方法：

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

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

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

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

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

字段 输出条件 描述
source 始终 name 的值。
severity 始终 的枚举值名称 eventType。
id 始终 id 的字符串表示形式。
message 始终 使用format字符串格式并使用固定区域性进行字符串转换的数据args。
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时。 计算机的名称。

另请参阅

适用于