EventLogTraceListener.TraceData Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные трассировки в журнал событий.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Записывает информацию трассировки, объект данных и информацию о событиях в журнал событий. |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Записывает информацию трассировки, массив объектов данных и информацию о событиях в журнал событий. |
- Исходный код:
- EventLogTraceListener.cs
- Исходный код:
- EventLogTraceListener.cs
- Исходный код:
- 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
Объект данных для записи в исходящий файл или поток.
- Атрибуты
Исключения
Комментарии
Важно!
Методы 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 |
- Исходный код:
- EventLogTraceListener.cs
- Исходный код:
- EventLogTraceListener.cs
- Исходный код:
- 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[]
Массив объектов данных.
- Атрибуты
Исключения
Комментарии
Важно!
Методы 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 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: