FileLogTraceListener.TraceData Метод

  • Ссылка

Определение

Пространство имен:
Microsoft.VisualBasic.Logging
Сборка:
Microsoft.VisualBasic.dll
Сборка:
Microsoft.VisualBasic.Forms.dll

Записывает данные трассировки в выходной файл.

Перегрузки

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 -> unit
Public 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

Выдаваемые данные трассировки.

Комментарии

Этот метод выполняет следующее:

  1. Форматирует данные и сведения о контексте для выходных данных.

  2. При необходимости создает новый файл журнала.

  3. Записывает сведения в файл журнала.

Дополнительные сведения о создании файлов журнала см. в разделе 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[] -> unit
Public 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[]

Выдаваемые данные массива объектов.

Комментарии

Этот метод выполняет следующее:

  1. Форматирует данные и контекстные сведения для выходных данных;

  2. При необходимости создает новый файл журнала.

  3. Записывает сведения в файл журнала.

Дополнительные сведения о создании файлов журнала см. в разделе 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. Имя компьютера.

См. также раздел

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