DelimitedListTraceListener.TraceEvent Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.TextWriterTraceListener.dll

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

Перегрузки

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Записывает сведения трассировки, сообщение и сведения о событии в исходящий файл или поток.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Записывает сведения трассировки, форматированный массив объектов данных и сведения о событии в исходящий файл или поток.

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

Исходный код:

DelimitedListTraceListener.cs

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

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

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

Комментарии

Значения sourceпараметров , eventTypeи id записываются в виде заголовка, за которым следуют message данные. Данные eventCache записываются в виде нижнего колонтитула, содержимое которого зависит от значения TraceOutputOptions свойства .

Важно!

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

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

Исходный код:

DelimitedListTraceListener.cs

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

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

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

args

Object[]

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

Комментарии

Значения sourceпараметров , eventTypeи id записываются в виде заголовка. Массив args объектов преобразуется в строку с помощью String.Format(String, Object[]) метода , передавая format строку и args массив для форматирования строки как части сообщения трассировки. Данные eventCache записываются в виде нижнего колонтитула, содержимое которого зависит от значения TraceOutputOptions свойства .

Важно!

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