TraceSource.TraceData Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные трассировки в прослушиватели трассировки в Listeners коллекции.
Перегрузки
| Имя | Описание |
|---|---|
| TraceData(TraceEventType, Int32, Object) |
Записывает данные трассировки в прослушиватели трассировки в Listeners коллекции с помощью указанного типа события, идентификатора события и данных трассировки. |
| TraceData(TraceEventType, Int32, Object[]) |
Записывает данные трассировки в прослушиватели трассировки в Listeners коллекции с помощью указанного типа события, идентификатора события и массива данных трассировки. |
TraceData(TraceEventType, Int32, Object)
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
Записывает данные трассировки в прослушиватели трассировки в Listeners коллекции с помощью указанного типа события, идентификатора события и данных трассировки.
public:
void TraceData(System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData(System.Diagnostics.TraceEventType eventType, int id, object? data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData(System.Diagnostics.TraceEventType eventType, int id, object data);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)Параметры
- eventType
- TraceEventType
Одно из значений перечисления, указывающее тип события данных трассировки.
- id
- Int32
Числовой идентификатор события.
- data
- Object
Данные трассировки.
- Атрибуты
Исключения
Предпринята попытка трассировать событие во время завершения.
Примеры
В следующем примере кода показано использование TraceData(TraceEventType, Int32, Object) метода для фильтрации и пересылки сообщения трассировки прослушивателям. Этот пример кода является частью более крупного примера, предоставленного для TraceSource класса.
// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
"SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
"SourceFilter should let this message through on the console trace listener.");
' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")
Комментарии
Метод TraceData , например TraceEvent метод, предназначен для автоматизированных средств, но также позволяет присоединять дополнительный объект, например экземпляр исключения, к трассировки.
Метод TraceData вызывает SourceSwitch.ShouldTrace метод объекта, возвращаемого SourceSwitch свойством Switch . Если ShouldTrace возвращается true, TraceData вызывает соответствующий TraceData метод для всех прослушивателей. В противном случае возвращается без TraceData вызова методов прослушивателей.
Note
Объект EventLogTraceListener ограничен максимальным id значением 65 535. Если указанное id значение больше 65 535, EventLogTraceListener объект использует 65 535.
Применяется к
TraceData(TraceEventType, Int32, Object[])
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
- Исходный код:
- TraceSource.cs
Записывает данные трассировки в прослушиватели трассировки в Listeners коллекции с помощью указанного типа события, идентификатора события и массива данных трассировки.
public:
void TraceData(System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData(System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData(System.Diagnostics.TraceEventType eventType, int id, params object[] data);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())Параметры
- eventType
- TraceEventType
Одно из значений перечисления, указывающее тип события данных трассировки.
- id
- Int32
Числовой идентификатор события.
- data
- Object[]
Массив объектов, содержащий данные трассировки.
- Атрибуты
Исключения
Предпринята попытка трассировать событие во время завершения.
Комментарии
Метод TraceData , например TraceEvent метод, предназначен для автоматизированных средств, но также позволяет присоединять дополнительные объекты, такие как экземпляр исключения и трассировка стека.
Метод TraceData вызывает ShouldTrace метод объекта, возвращаемого SourceSwitch свойством Switch . Если ShouldTrace возвращается true, TraceData вызывает соответствующий TraceData метод для всех прослушивателей. В противном случае возвращается без TraceData вызова методов прослушивателей.
Note
Объект EventLogTraceListener ограничен максимальным id значением 65 535. Если указанное id значение больше 65 535, EventLogTraceListener объект использует 65 535.
