EventLogTraceListener.TraceData 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.EventLog.dll

包:

System.Diagnostics.EventLog v8.0.0

将跟踪数据写入事件日志中。

重载

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	将跟踪信息、数据对象和事件信息写入事件日志中。
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	将跟踪信息、数据对象的数组和事件信息写入事件日志中。

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Source:

EventLogTraceListener.cs

将跟踪信息、数据对象和事件信息写入事件日志中。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

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

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

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data As Object)

参数

eventCache

TraceEventCache

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

source

String

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

severity

TraceEventType

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

id

Int32

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

data

Object

要向输出文件或流中写入的数据对象。

属性

ComVisibleAttribute

例外

ArgumentException

未指定 source。

- 或 -

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

注解

重要

这些 TraceData 方法不应由应用程序代码调用。 它们由 、 Trace和 TraceSource 类的方法Debug调用，以输出跟踪数据。

方法 TraceData 与 方法一样 TraceEvent 适用于自动化工具，但也允许将其他对象（例如异常实例）附加到跟踪。

eventCache和 source 参数用于确定是否应跟踪事件。 id 用于创建 EventInstance 对象， TraceEventTypeEventLogEntryType 等同于 属性的 EntryType 。 EventInstance使用 WriteEvent 方法使用 对象（格式为字符串）写入事件日志data。

注意

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

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

Source:

EventLogTraceListener.cs

将跟踪信息、数据对象的数组和事件信息写入事件日志中。

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

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

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

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data As Object())

参数

eventCache

TraceEventCache

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

source

String

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

severity

TraceEventType

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

id

Int32

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

data

Object[]

数据对象的数组。

属性

ComVisibleAttribute

例外

ArgumentException

未指定 source。

- 或 -

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

注解

重要

这些 TraceData 方法不应由应用程序代码调用。 它们由 、 Trace和 TraceSource 类的方法Debug调用，以输出跟踪数据。

方法 TraceData 与 方法一样 TraceEvent 适用于自动化工具，但也允许将其他对象（例如异常实例）附加到跟踪。

severity和 id 参数数据用于创建对象EventInstance，该对象使用数据对象数组中的数据写入事件日志。

eventCache和 source 参数用于确定是否应跟踪事件。 id 用于创建 EventInstance 对象， TraceEventTypeEventLogEntryType 等同于 属性的 EntryType 。 EventInstance使用 WriteEvent 方法使用 对象数组（格式为字符串数组）写入事件日志data。

注意

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