EventLogTraceListener.TraceEvent Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает информацию трассировки в журнал событий.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Записывает информацию трассировки, сообщение и информацию о событиях в журнал событий. |
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 ^ 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
Трассировочное сообщение.
- Атрибуты
Исключения
Комментарии
Важно!
Методы TraceEvent не предназначены для вызова из кода приложения. Эти методы вызываются методами Debugклассов , Traceи TraceSource для записи данных трассировки.
Метод TraceEvent предназначен для трассировки событий, которые могут автоматически обрабатываться средствами. Например, средство мониторинга может уведомлять администратора, если определенное событие отслеживается определенным источником.
Параметры eventCache
и source
используются для определения необходимости трассировки события. id
используется для создания EventInstance объекта и TraceEventType приравнивается к EventLogEntryType объекту EntryType для свойства . Записывается EventInstance в журнал событий с данными message
с помощью 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 |
- Исходный код:
- 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
, содержащий несколько объектов (или ни одного), которые необходимо отформатировать.
- Атрибуты
Исключения
Комментарии
Важно!
Методы 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, используется максимальное значение.
Применяется к
.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 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: