TraceSource.TraceEvent Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает сообщение о событии трассировки в прослушиватели трассировки в 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
- Исходный код:
- 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 -> unitPublic Sub TraceEvent (eventType As TraceEventType, id As Integer)Параметры
- eventType
- TraceEventType
Одно из значений перечисления, указывающее тип события данных трассировки.
- id
- Int32
Числовой идентификатор события.
- Атрибуты
Исключения
Предпринята попытка трассировать событие во время завершения.
Примеры
В следующем примере кода показано использование метода для передачи 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
- Исходный код:
- 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 -> unitPublic Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)Параметры
- eventType
- TraceEventType
Одно из значений перечисления, указывающее тип события данных трассировки.
- id
- Int32
Числовой идентификатор события.
- message
- String
Сообщение трассировки для записи.
- Атрибуты
Исключения
Предпринята попытка трассировать событие во время завершения.
Примеры
В следующем примере кода показано использование метода для передачи TraceEvent(TraceEventType, Int32) события трассировки прослушивателям. Этот пример кода является частью более крупного примера, предоставленного для TraceSource класса.
// 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")
Комментарии
Метод 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, Object[])
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
- Исходный код:
- 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[] -> unitPublic 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 Массив, содержащий ноль или больше объектов для форматирования.
- Атрибуты
Исключения
format равно null.
format недопустим.
–или–
Число, указывающее, что аргумент форматирования меньше нуля или больше или равно числу указанных объектов для форматирования.
Предпринята попытка трассировать событие во время завершения.
Примеры
В следующем примере кода показано использование метода для передачи TraceEvent(TraceEventType, Int32) события трассировки прослушивателям. Этот пример кода является частью более крупного примера, предоставленного для TraceSource класса.
// 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")
Комментарии
Дополнительные сведения о параметре format см. в разделе "Составное форматирование".
Метод TraceEvent предназначен для трассировки событий, которые могут обрабатываться автоматически средствами. Например, средство мониторинга может уведомить администратора, если определенное событие отслеживается определенным источником.
Метод TraceEvent вызывает ShouldTrace метод объекта, возвращаемого SourceSwitch свойством Switch . Если ShouldTrace возвращается true, TraceEvent вызывает соответствующий TraceEvent метод каждого прослушивателя. В противном случае возвращается без TraceEvent вызова методов прослушивателей.
Содержимое трассировки зависит от прослушивателя. Метод по умолчанию TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) записывает исходное имя, тип события и числовое удостоверение в заголовке трассировки, а затем вызывает String.Format(IFormatProvider, String, Object[]) метод, передав format строку и args массив и используя CultureInfo.InvariantCulture свойство для форматирования строки в виде выходных данных сообщения.
Замечание
Объект EventLogTraceListener ограничен максимальным id значением 65 535. Если указанное id значение больше 65 535, EventLogTraceListener объект использует 65 535.
См. также раздел
- Составное форматирование
- Стандартные строки в числовом формате
- Настраиваемые числовые строковые форматы
- Стандартные строки формата DateTime
- Настраиваемые строки формата DateTime
- Форматные строки для перечисления
- Типы форматирования в .NET
