TraceSource.TraceData Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные трассировки в прослушиватели трассировки коллекции Listeners.
Перегрузки
| TraceData(TraceEventType, Int32, Object) |
Записывает данные трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события, а также данные трассировки. |
| TraceData(TraceEventType, Int32, Object[]) |
Записывает данные трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события, а также данные трассировки. |
TraceData(TraceEventType, Int32, Object)
- Исходный код:
- 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 вызова методов прослушивателей.
Примечание
Максимальное EventLogTraceListener значение объекта — id 65 535. Если указанное id значение больше 65 535, EventLogTraceListener объект использует значение 65 535.
Применяется к
TraceData(TraceEventType, Int32, Object[])
- Исходный код:
- 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 вызова методов прослушивателей.
Примечание
Максимальное EventLogTraceListener значение объекта — id 65 535. Если указанное id значение больше 65 535, EventLogTraceListener объект использует значение 65 535.
