EventLogTraceListener.TraceEvent Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Пакет:

System.Diagnostics.EventLog v8.0.0

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

Перегрузки

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Записывает информацию трассировки, сообщение и информацию о событиях в журнал событий.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Записывает информацию трассировки, форматированный массив объектов и информацию о событиях в журнал событий.

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

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

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

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

Атрибуты

ComVisibleAttribute

Исключения

ArgumentException

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

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

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, содержащий несколько объектов (или ни одного), которые необходимо отформатировать.

Атрибуты

ComVisibleAttribute

Исключения

ArgumentException

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