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)

Исходный код:

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

Объект, содержащий текущие идентификаторы процесса и потока, а также сведения о трассировке стека.

source

String

Имя, используемое для идентификации выходных данных, обычно имя приложения, создавшего событие трассировки.

severity

TraceEventType

Одно из значений перечисления, с помощью которого задается тип события, вызвавшего трассировку.

id

Int32

Числовой идентификатор события. Сочетание source и id уникально идентифицирует событие.

data

Object

Объект данных для записи в исходящий файл или поток.

Атрибуты

ComVisibleAttribute

Исключения

ArgumentException

source не задан.

-или-

Длина строки записи журнала превышает 32766 знаков.

Комментарии

Важно!

Методы TraceData не предназначены для вызова из кода приложения. Они вызываются методами Debugклассов , Traceи TraceSource для вывода данных трассировки.

Метод TraceData , как и TraceEvent метод , предназначен для автоматизированных средств, но также позволяет присоединять к трассировки дополнительные объекты, например экземпляр исключения.

Параметры eventCache и source используются для определения необходимости трассировки события. id используется для создания EventInstance объекта и TraceEventType приравнивается к объекту EventLogEntryTypeEntryType для свойства . записывается EventInstance в журнал событий с data объектом , отформатированным в виде строки, с помощью WriteEvent метода .

Примечание

Максимальное значение id параметра — 65 535. Если указанное id значение больше 65 535, используется максимальное значение.

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

Исходный код:

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

Объект, содержащий текущие идентификаторы процесса и потока, а также сведения о трассировке стека.

source

String

Имя, используемое для идентификации выходных данных, обычно имя приложения, создавшего событие трассировки.

severity

TraceEventType

Одно из значений перечисления, с помощью которого задается тип события, вызвавшего трассировку.

id

Int32

Числовой идентификатор события. Сочетание source и id уникально идентифицирует событие.

data

Object[]

Массив объектов данных.

Атрибуты

ComVisibleAttribute

Исключения

ArgumentException

source не задан.

-или-

Длина строки записи журнала превышает 32766 знаков.

Комментарии

Важно!

Методы TraceData не предназначены для вызова из кода приложения. Они вызываются методами Debugклассов , Traceи TraceSource для вывода данных трассировки.

Метод TraceData , как и TraceEvent метод , предназначен для автоматизированных средств, но также позволяет присоединять к трассировки дополнительные объекты, например экземпляр исключения.

Данные severity параметра и id используются для создания EventInstance объекта , который записывается в журнал событий с данными из массива объектов данных.

Параметры eventCache и source используются для определения необходимости трассировки события. id используется для создания EventInstance объекта и TraceEventType приравнивается к объекту EventLogEntryTypeEntryType для свойства . Записывается EventInstance в журнал событий с массивом data объектов, отформатированным в виде массива строк, с помощью WriteEvent метода .

Примечание

Максимальное значение id параметра — 65 535. Если указанное id значение больше 65 535, используется максимальное значение.