Поделиться через


FileLogTraceListener.TraceEvent Метод

Определение

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

Перегрузки

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

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

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Записывает сведения трассировки, форматированный массив объектов данных и сведения о событии в исходящий файл или поток.

Комментарии

TraceEvent методы не предназначены для вызова в коде приложения. Эти методы вызываются членами Debugклассов , Traceи TraceSource для записи данных трассировки в выходные данные.

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

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

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)

Параметры

eventCache
TraceEventCache

Объект TraceEventCache, содержащий текущие идентификатор процесса, идентификатор потока и сведения о трассировке стека.

source
String

Имя источника трассировки, вызвавшего этот метод.

eventType
TraceEventType

Одно из значений перечисления TraceEventType.

id
Int32

Числовой идентификатор события.

message
String

Записываемое сообщение.

Комментарии

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

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

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

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

Дополнительные сведения о создании файлов журнала см. в разделе FullLogFileName.

В этой таблице перечислены поля вывода в том порядке, в котором они отображаются. Поля разделяются строкой, указанной свойством Delimiter , а за ними следует признак конца строки.

Поле Условие вывода Описание
source Всегда. Значение name.
severity Всегда. Имя eventTypeперечисления значения .
id Всегда. Строковое представление параметра id.
message Всегда. Значение message.
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. Имя компьютера.

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

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

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Записывает сведения трассировки, форматированный массив объектов данных и сведения о событии в исходящий файл или поток.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Параметры

eventCache
TraceEventCache

Объект TraceEventCache, содержащий текущие идентификатор процесса, идентификатор потока и сведения о трассировке стека.

source
String

Имя источника трассировки, вызвавшего этот метод.

eventType
TraceEventType

Одно из значений перечисления TraceEventType.

id
Int32

Числовой идентификатор события.

format
String

Строка формата, не содержащая элементов формата или содержащая один либо несколько элементов формата, связанных с объектами в массиве args.

args
Object[]

Массив Object, содержащий несколько объектов (или ни одного), которые необходимо отформатировать.

Комментарии

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

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

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

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

Дополнительные сведения о создании файла журнала см. в разделе FullLogFileName.

В этой таблице перечислены поля вывода в том порядке, в котором они отображаются. Поля разделяются строкой, указанной свойством Delimiter , и за которой следует признак конца строки.

Поле Условие вывода Описание
source Всегда Значение name.
severity Всегда Имя eventTypeперечисления значения .
id Всегда Строковое представление параметра id.
message Всегда Данные в args формате со строкой format и с использованием инвариантного языка и региональных параметров для преобразования строк.
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. Имя компьютера.

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

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