FileLogTraceListener.TraceData Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные трассировки в выходной файл.
Перегрузки
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Записывает сведения трассировки, объект данных и сведения о событии в исходящий файл или поток. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Записывает сведения трассировки, массив объектов данных и сведения о событии в выходной файл или поток. |
Комментарии
TraceData методы не предназначены для вызова в коде приложения. Эти методы вызываются членами Debugклассов , Traceи TraceSource для записи данных трассировки в выходные данные.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)
Записывает сведения трассировки, объект данных и сведения о событии в исходящий файл или поток.
public:
override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unitPublic Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, data As Object)Параметры
- eventCache
- TraceEventCache
Объект TraceEventCache, содержащий текущие идентификатор процесса, идентификатор потока и сведения о трассировке стека.
- source
- String
Имя источника трассировки, вызвавшего этот метод.
- eventType
- TraceEventType
Одно из значений перечисления TraceEventType.
- id
- Int32
Числовой идентификатор события.
- data
- Object
Выдаваемые данные трассировки.
Комментарии
Этот метод выполняет следующее:
Форматирует данные и сведения о контексте для выходных данных.
При необходимости создает новый файл журнала.
Записывает сведения в файл журнала.
Дополнительные сведения о создании файлов журнала см. в разделе FullLogFileName.
В следующей таблице перечислены поля выходных данных в порядке их отображения. Поля разделяются строкой, указанной свойством Delimiter , а за ними следует признак конца строки.
| Поле | Условие вывода | Описание |
|---|---|---|
source |
Всегда | Значение name. |
severity |
Всегда | Имя eventTypeперечисления значения . |
id |
Всегда | Строковое представление параметра id. |
message |
Всегда | Строковое представление параметра data. |
callStack |
Callstack Если флаг задан в свойстве TraceOutputOptions . | Свойство Callstack объекта eventCache. |
CorrelationID |
LogicalOperationStack Если флаг задан в свойстве TraceOutputOptions . | Свойство ThreadId объекта eventCache. |
DateTime |
DateTime Если флаг задан в свойстве TraceOutputOptions . | Строковое DateTime представление свойства объекта eventCache. Для преобразования строк используется инвариантный язык и региональные параметры. |
ProcessID |
ProcessId Если флаг задан в свойстве TraceOutputOptions . | Строковое ProcessId представление свойства объекта eventCache. Для преобразования строк используется инвариантный язык и региональные параметры. |
ThreadID |
ThreadId Если флаг задан в свойстве TraceOutputOptions . | Свойство ThreadId объекта eventCache. |
Timestamp |
Timestamp Если флаг задан в свойстве TraceOutputOptions . | Строковое Timestamp представление свойства объекта eventCache. Для преобразования строк используется инвариантный язык и региональные параметры. |
HostName |
IncludeHostName Если свойство имеет значение True. |
Имя компьютера. |
См. также раздел
Применяется к
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])
Записывает сведения трассировки, массив объектов данных и сведения о событии в выходной файл или поток.
public:
override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unitPublic Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, ParamArray data As Object())Параметры
- eventCache
- TraceEventCache
Объект TraceEventCache, содержащий текущие идентификатор процесса, идентификатор потока и сведения о трассировке стека.
- source
- String
Имя источника трассировки, вызвавшего этот метод.
- eventType
- TraceEventType
Одно из значений перечисления TraceEventType.
- id
- Int32
Числовой идентификатор события.
- data
- Object[]
Выдаваемые данные массива объектов.
Комментарии
Этот метод выполняет следующее:
Форматирует данные и контекстные сведения для выходных данных;
При необходимости создает новый файл журнала.
Записывает сведения в файл журнала.
Дополнительные сведения о создании файлов журнала см. в разделе FullLogFileName.
В этой таблице перечислены поля вывода в порядке их отображения. Поля разделяются строкой, указанной свойством Delimiter , а за ними следует признак конца строки.
| Поле | Условие вывода | Описание |
|---|---|---|
source |
Всегда | Значение name. |
severity |
Всегда | Имя eventTypeперечисления значения . |
id |
Всегда | Строковое представление параметра id. |
message |
Всегда | Строка, состоящая из строкового представления каждого элемента в data, разделенного Delimiter. |
callStack |
Callstack Если флаг задан в свойстве TraceOutputOptions . | Свойство Callstack объекта eventCache. |
CorrelationID |
LogicalOperationStack Если флаг задан в свойстве TraceOutputOptions . | Свойство ThreadId объекта eventCache. |
DateTime |
DateTime Если флаг задан в свойстве TraceOutputOptions . | Строковое DateTime представление свойства объекта eventCache. Для преобразования строк используется инвариантный язык и региональные параметры. |
ProcessID |
ProcessId Если флаг задан в свойстве TraceOutputOptions . | Строковое ProcessId представление свойства объекта eventCache. Для преобразования строк используется инвариантный язык и региональные параметры. |
ThreadID |
ThreadId Если флаг задан в свойстве TraceOutputOptions . | Свойство ThreadId объекта eventCache. |
Timestamp |
Timestamp Если флаг задан в свойстве TraceOutputOptions . | Строковое Timestamp представление свойства объекта eventCache. Для преобразования строк используется инвариантный язык и региональные параметры. |
HostName |
IncludeHostName Если свойство имеет значение True. |
Имя компьютера. |
