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


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 -> unit
Public 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 -> unit
Public 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[] -> 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, содержащий несколько объектов (или ни одного), которые необходимо отформатировать.

Атрибуты

Исключения

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.

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

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