EventLogTraceListener.TraceEvent 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.EventLog.dll

包:

System.Diagnostics.EventLog v8.0.0

将事件跟踪信息写入事件日志中。

重载

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	将跟踪信息、消息和事件信息写入事件日志中。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	将跟踪信息、格式化对象数组和事件信息写入事件日志中。

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

Source:

EventLogTraceListener.cs

将跟踪信息、消息和事件信息写入事件日志中。

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

参数

eventCache

TraceEventCache

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

source

String

标识输出时使用的名称，通常为生成跟踪事件的应用程序的名称。

severity

TraceEventType

指定引发跟踪的事件的类型的其中一个枚举值。

id

Int32

事件的数值标识符。 source 和 id 的组合可以唯一地标识一个事件。

message

String

跟踪消息。

属性

ComVisibleAttribute

例外

ArgumentException

未指定 source。

- 或 -

日志项超过 32,766 个字符。

注解

重要

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

方法 TraceEvent 旨在跟踪可由工具自动处理的事件。 例如，如果特定事件由特定源跟踪，监视工具可以通知管理员。

eventCache和 source 参数用于确定是否应跟踪事件。 id 用于创建 EventInstance 对象， TraceEventTypeEventLogEntryType 等同于 属性的 EntryType 。 EventInstance使用 WriteEvent 方法将数据写入事件日志message。

注意

参数的 id 最大值为 65,535。 id如果指定的值大于 65,535，则使用最大值。

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

Source:

EventLogTraceListener.cs

将跟踪信息、格式化对象数组和事件信息写入事件日志中。

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args As Object())

参数

eventCache

TraceEventCache

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

source

String

标识输出时使用的名称，通常为生成跟踪事件的应用程序的名称。

severity

TraceEventType

指定引发跟踪的事件的类型的其中一个枚举值。

id

Int32

事件的数值标识符。 source 和 id 的组合可以唯一地标识一个事件。

format

String

包含零个或多个格式项的格式字符串，这些项与 args 数组中的对象相对应。

args

Object[]

包含零个或多个要格式化的对象的 object 数组。

属性

ComVisibleAttribute

例外

ArgumentException

未指定 source。

- 或 -

日志项超过 32,766 个字符。

注解

重要

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

方法 TraceEvent 旨在跟踪可由工具自动处理的事件。 例如，如果特定事件由特定源跟踪，监视工具可以通知管理员。

eventCache和 source 参数用于确定是否应跟踪事件。 id 用于创建 EventInstance 对象， TraceEventTypeEventLogEntryType 等同于 属性的 EntryType 。 EventInstance使用 WriteEvent 方法将 写入事件日志，并使用从 format 和 args 参数获取的消息。 使用 argsFormat 方法将对象数组转换为字符串，传递 format 字符串和 args 数组以将字符串格式化为事件日志的消息。

注意

参数的 id 最大值为 65,535。 id如果指定的值大于 65,535，则使用最大值。