FileLogTraceListener.TraceEvent 方法

定义

命名空间:

Microsoft.VisualBasic.Logging

程序集:

Microsoft.VisualBasic.Forms.dll

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

重载

名称	说明
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	将跟踪信息、消息和事件信息写入输出文件或流。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	将跟踪信息、对象的格式化数组和事件信息写入输出文件或流。

注解

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

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

Source:

FileLogTraceListener.vb

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

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

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

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 设置标志时。	的Callstack属性。eventCache
CorrelationID	在 LogicalOperationStack 属性中 TraceOutputOptions 设置标志时。	的ThreadId属性。eventCache
DateTime	在 DateTime 属性中 TraceOutputOptions 设置标志时。	属性的DateTimeeventCache字符串表示形式。 固定区域性用于字符串转换。
ProcessID	在 ProcessId 属性中 TraceOutputOptions 设置标志时。	属性的ProcessIdeventCache字符串表示形式。 固定区域性用于字符串转换。
ThreadID	在 ThreadId 属性中 TraceOutputOptions 设置标志时。	的ThreadId属性。eventCache
Timestamp	在 Timestamp 属性中 TraceOutputOptions 设置标志时。	属性的TimestampeventCache字符串表示形式。 固定区域性用于字符串转换。
HostName	当 IncludeHostName 属性为 True.	计算机的名称。

另请参阅

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType

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

Source:

FileLogTraceListener.vb

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

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

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

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	始终	args采用字符串格式的数据format，并使用固定区域性进行字符串转换。
callStack	在 Callstack 属性中 TraceOutputOptions 设置标志时。	的Callstack属性。eventCache
CorrelationID	在 LogicalOperationStack 属性中 TraceOutputOptions 设置标志时。	的ThreadId属性。eventCache
DateTime	在 DateTime 属性中 TraceOutputOptions 设置标志时。	属性的DateTimeeventCache字符串表示形式。 固定区域性用于字符串转换。
ProcessID	在 ProcessId 属性中 TraceOutputOptions 设置标志时。	属性的ProcessIdeventCache字符串表示形式。 固定区域性用于字符串转换。
ThreadID	在 ThreadId 属性中 TraceOutputOptions 设置标志时。	的ThreadId属性。eventCache
Timestamp	在 Timestamp 属性中 TraceOutputOptions 设置标志时。	属性的TimestampeventCache字符串表示形式。 固定区域性用于字符串转换。
HostName	当 IncludeHostName 属性为 True.	计算机的名称。

另请参阅

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType