EventLogTraceListener.TraceData Метод

Определение

Записывает данные трассировки в журнал событий.

Перегрузки

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

Записывает информацию трассировки, объект данных и информацию о событиях в журнал событий.

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

Записывает информацию трассировки, массив объектов данных и информацию о событиях в журнал событий.

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

Исходный код:
EventLogTraceListener.cs
Исходный код:
EventLogTraceListener.cs
Исходный код:
EventLogTraceListener.cs

Записывает информацию трассировки, объект данных и информацию о событиях в журнал событий.

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

Параметры

eventCache
TraceEventCache

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

source
String

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

severity
TraceEventType

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

id
Int32

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

data
Object

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

Атрибуты

Исключения

source не задан.

-или-

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

Комментарии

Важно!

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

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

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

Примечание

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

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

Исходный код:
EventLogTraceListener.cs
Исходный код:
EventLogTraceListener.cs
Исходный код:
EventLogTraceListener.cs

Записывает информацию трассировки, массив объектов данных и информацию о событиях в журнал событий.

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

Параметры

eventCache
TraceEventCache

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

source
String

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

severity
TraceEventType

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

id
Int32

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

data
Object[]

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

Атрибуты

Исключения

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, используется максимальное значение.

Применяется к

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9