TraceSource.TraceData Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.TraceSource.dll

Записывает данные трассировки в прослушиватели трассировки коллекции Listeners.

Перегрузки

TraceData(TraceEventType, Int32, Object)	Записывает данные трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события, а также данные трассировки.
TraceData(TraceEventType, Int32, Object[])	Записывает данные трассировки в прослушиватели трассировки коллекции Listeners, используя для этого указанный тип и идентификатор события, а также данные трассировки.

TraceData(TraceEventType, Int32, Object)

Исходный код:

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")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unit

Public Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)

Параметры

eventType

TraceEventType

Одно из значений перечисления, с помощью которого можно определить тип события для данных трассировки.

id

Int32

Числовой идентификатор события.

data

Object

Данные трассировки.

Атрибуты

ConditionalAttribute

Исключения

ObjectDisposedException

Предпринята попытка трассировки события в процессе завершения.

Примеры

В следующем примере кода показано использование 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

Записывает данные трассировки в прослушиватели трассировки коллекции 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")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())

Параметры

eventType

TraceEventType

Одно из значений перечисления, с помощью которого можно определить тип события для данных трассировки.

id

Int32

Числовой идентификатор события.

data

Object[]

Массив объектного типа, содержащий данные трассировки.

Атрибуты

ConditionalAttribute

Исключения

ObjectDisposedException

Предпринята попытка трассировки события в процессе завершения.

Комментарии

Метод TraceData , как и TraceEvent метод , предназначен для автоматизированных средств, но он также позволяет присоединять к трассировке дополнительные объекты, такие как экземпляр исключения и трассировка стека.

Метод TraceData вызывает ShouldTrace метод объекта , SourceSwitch возвращаемого свойством Switch . Если ShouldTrace возвращает значение true, TraceData вызывает соответствующий TraceData метод для всех прослушивателей. В противном случае возвращает без TraceData вызова методов прослушивателей.

Примечание

Максимальное EventLogTraceListener значение объекта — id 65 535. Если указанное id значение больше 65 535, EventLogTraceListener объект использует значение 65 535.