EventLogTraceListener.TraceData 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.EventLog.dll

包:

System.Diagnostics.EventLog v11.0.0-preview.5.26302.115

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

重载

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

TraceData(TraceEventCache, String, TraceEventType, Int32, Object, 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

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

eventCache

TraceEventCache

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

source

String

用于标识输出的名称;通常生成跟踪事件的应用程序的名称。

severity

TraceEventType

枚举值之一，该值指定导致跟踪的事件的类型。

id

Int32

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

data

Object

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

属性

ComVisibleAttribute

例外

ArgumentException

未指定 source。

-或-

日志条目字符串超过 32,766 个字符。

注解

Important

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

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

参数eventCachesource用于确定是否应跟踪事件。 id用于创建对象EventInstance，TraceEventType该对象等同于EventLogEntryType属性。EntryType 使用EventInstance该方法将对象格式化为字符串data的事件日志WriteEvent中写入该对象。

注释

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

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[], 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[]

数据对象的数组。

eventCache

TraceEventCache

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

source

String

用于标识输出的名称;通常生成跟踪事件的应用程序的名称。

severity

TraceEventType

枚举值之一，该值指定导致跟踪的事件的类型。

id

Int32

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

data

Object[]

数据对象的数组。

属性

ComVisibleAttribute

例外

ArgumentException

未指定 source。

-或-

日志条目字符串超过 32,766 个字符。

注解

Important

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

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

参数severityid数据用于创建一个EventInstance对象，该对象使用数据对象数组中的数据写入事件日志。

参数eventCachesource用于确定是否应跟踪事件。 id用于创建对象EventInstance，TraceEventType该对象等同于EventLogEntryType属性。EntryType 使用EventInstance该方法将对象数组格式化为字符串数组的事件日志中写入该事件data。WriteEvent

注释

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