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
Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции 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
Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции 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
Записывает сообщение о событии трассировки в прослушиватели трассировки коллекции 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.
См. также раздел
- Составное форматирование
- Строки стандартных числовых форматов
- Строки настраиваемых числовых форматов
- Стандартные строки формата даты и времени
- Настраиваемые строки формата даты и времени
- Строки форматов перечисления
- Типы форматирования в .NET
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по