FileLogTraceListener.TraceEvent 方法

定义

命名空间:

Microsoft.VisualBasic.Logging

程序集:

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时。	计算机的名称。

另请参阅

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType

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时。	计算机的名称。

另请参阅

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType