Поделиться через


EventLogTraceListener.TraceEvent Метод

Определение

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

Перегрузки

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

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

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

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

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

Исходный код:
EventLogTraceListener.cs
Исходный код:
EventLogTraceListener.cs
Исходный код:
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

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

source
String

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

severity
TraceEventType

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

id
Int32

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

message
String

Трассировочное сообщение.

Атрибуты

Исключения

source не задан.

-или-

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

Комментарии

Важно!

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

Метод TraceEvent предназначен для трассировки событий, которые могут автоматически обрабатываться средствами. Например, средство мониторинга может уведомлять администратора, если определенное событие отслеживается определенным источником.

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

Примечание

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

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

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

Исходный код:
EventLogTraceListener.cs
Исходный код:
EventLogTraceListener.cs
Исходный код:
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

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

source
String

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

severity
TraceEventType

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

id
Int32

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

format
String

Строка форматирования, содержащая 0 или больше элементов форматирования, соответствующих объектам в массиве args.

args
Object[]

Массив object, содержащий несколько объектов (или ни одного), которые необходимо отформатировать.

Атрибуты

Исключения

source не задан.

-или-

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

Комментарии

Важно!

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

Метод TraceEvent предназначен для трассировки событий, которые могут автоматически обрабатываться средствами. Например, средство мониторинга может уведомлять администратора, если определенное событие отслеживается определенным источником.

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

Примечание

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

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