TraceSource.TraceEvent Метод

Ссылка

Определение

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

Сборка:: System.Diagnostics.TraceSource.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции Listeners.

Перегрузки

TraceEvent(TraceEventType, Int32)	Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события.
TraceEvent(TraceEventType, Int32, String)	Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события, а также сообщение.
TraceEvent(TraceEventType, Int32, String, Object[])	Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события, а также массив аргументов и формат.

TraceEvent(TraceEventType, Int32)

Исходный код:: TraceSource.cs

Исходный код:: TraceSource.cs

Исходный код:: TraceSource.cs

Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

Параметры

eventType: TraceEventType

Одно из значений перечисления, с помощью которого можно определить тип события для данных трассировки.

id: Int32

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

Атрибуты: ConditionalAttribute

Исключения

ObjectDisposedException

Предпринята попытка трассировки события в процессе завершения.

Примеры

В следующем примере кода показано использование метода для TraceEvent(TraceEventType, Int32) передачи события трассировки прослушивателям. Этот пример входит в состав более крупного примера использования класса TraceSource.

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

Метод TraceEvent предназначен для трассировки событий, которые могут автоматически обрабатываться средствами. Например, средство мониторинга может уведомлять администратора, если определенное событие отслеживается определенным источником.

Метод TraceEvent вызывает ShouldTrace метод объекта, SourceSwitch возвращаемого свойством Switch . Если ShouldTrace возвращает trueзначение , TraceEvent вызывает соответствующий TraceEvent метод каждого прослушивателя. В противном случае возвращает без TraceEvent вызова методов прослушивателей.

Содержимое трассировки зависит от прослушивателя. Если метод не переопределен реализацией прослушивателя, выходными данными по умолчанию является имя источника трассировки, его числовое удостоверение и тип события. Дополнительное содержимое трассировки зависит от значения свойства прослушивателя TraceOutputOptions .

Примечание

Максимальное EventLogTraceListener значение объекта — id 65 535. Если указанное id значение больше 65 535, EventLogTraceListener использует значение 65 535.

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

TraceEvent(TraceEventType, Int32, String)

Исходный код:: TraceSource.cs

Исходный код:: TraceSource.cs

Исходный код:: TraceSource.cs

Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события, а также сообщение.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

Параметры

eventType: TraceEventType

Одно из значений перечисления, с помощью которого можно определить тип события для данных трассировки.

id: Int32

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

message: String

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

Атрибуты: ConditionalAttribute

Исключения

ObjectDisposedException

Предпринята попытка трассировки события в процессе завершения.

Примеры

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");

' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

Содержимое трассировки зависит от прослушивателя. Если метод не переопределен реализацией прослушивателя, выходными данными по умолчанию будет имя источника трассировки, его числовое удостоверение, тип события и сообщение. Дополнительное содержимое трассировки зависит от значения свойства прослушивателя TraceOutputOptions .

Примечание

Максимальное EventLogTraceListener значение объекта — id 65 535. Если указанное id значение больше 65 535, EventLogTraceListener объект использует 65 535.

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

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

Исходный код:: TraceSource.cs

Исходный код:: TraceSource.cs

Исходный код:: TraceSource.cs

Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события, а также массив аргументов и формат.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Параметры

eventType: TraceEventType

Одно из значений перечисления, с помощью которого можно определить тип события для данных трассировки.

id: Int32

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

format: String

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

args: Object[]

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

Атрибуты: ConditionalAttribute

Исключения

ArgumentNullException

format имеет значение null.

FormatException

format недопустим.

-или-

Число, указывающее аргумент для форматирования, меньше нуля или больше или равно числу указанных объектов для форматирования.

ObjectDisposedException

Предпринята попытка трассировки события в процессе завершения.

Примеры

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");

' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

Содержимое трассировки зависит от прослушивателя. Метод по умолчанию TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) записывает имя источника, тип события и числовое удостоверение в заголовке трассировки, а затем вызывает String.Format(IFormatProvider, String, Object[]) метод , передавая format строку и args массив и используя CultureInfo.InvariantCulture свойство для форматирования строки в качестве выходных данных сообщения.

Примечание

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

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

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

TraceSource.TraceEvent Метод

Определение

Перегрузки

TraceEvent(TraceEventType, Int32)

Параметры

Исключения

Примеры

Комментарии

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

TraceEvent(TraceEventType, Int32, String)

Параметры

Исключения

Примеры

Комментарии

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

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

Параметры

Исключения

Примеры

Комментарии

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

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

Дополнительные ресурсы