TraceSource.TraceData Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.TraceSource.dll

Zapisuje dane śledzenia do odbiorników śledzenia w kolekcji Listeners .

Przeciążenia

TraceData(TraceEventType, Int32, Object)	Zapisuje dane śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i danych śledzenia.
TraceData(TraceEventType, Int32, Object[])	Zapisuje dane śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i tablicy danych śledzenia.

TraceData(TraceEventType, Int32, Object)

Źródło:

TraceSource.cs

Zapisuje dane śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i danych śledzenia.

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)

Parametry

eventType

TraceEventType

Jedna z wartości wyliczenia określająca typ zdarzenia danych śledzenia.

id

Int32

Identyfikator liczbowy zdarzenia.

data

Object

Dane śledzenia.

Atrybuty

ConditionalAttribute

Wyjątki

ObjectDisposedException

Podjęto próbę śledzenia zdarzenia podczas finalizacji.

Przykłady

Poniższy przykład kodu przedstawia użycie TraceData(TraceEventType, Int32, Object) metody do filtrowania i przekazywania komunikatu śledzenia do odbiorników. Ten przykład kodu jest częścią większego przykładu udostępnionego TraceSource dla klasy .

// 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.")

Uwagi

Metoda TraceData , podobnie jak TraceEvent metoda, jest przeznaczona dla zautomatyzowanych narzędzi, ale umożliwia również dołączanie dodatkowego obiektu, takiego jak wystąpienie wyjątku, do śledzenia.

Metoda TraceData wywołuje metodę SourceSwitch.ShouldTraceSourceSwitch obiektu zwróconego Switch przez właściwość . Jeśli ShouldTrace metoda zwraca truewartość , TraceData wywołuje odpowiednią TraceData metodę na wszystkich odbiornikach. TraceData W przeciwnym razie zwraca wartość bez wywoływania metod odbiorników.

Uwaga

Obiekt EventLogTraceListener jest ograniczony do maksymalnej id wartości 65 535. Jeśli określona id wartość jest większa niż 65 535, EventLogTraceListener obiekt używa wartości 65 535.

TraceData(TraceEventType, Int32, Object[])

Źródło:

TraceSource.cs

Zapisuje dane śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i tablicy danych śledzenia.

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())

Parametry

eventType

TraceEventType

Jedna z wartości wyliczenia określająca typ zdarzenia danych śledzenia.

id

Int32

Identyfikator liczbowy zdarzenia.

data

Object[]

Tablica obiektów zawierająca dane śledzenia.

Atrybuty

ConditionalAttribute

Wyjątki

ObjectDisposedException

Podjęto próbę śledzenia zdarzenia podczas finalizacji.

Uwagi

Metoda TraceData , podobnie jak TraceEvent metoda, jest przeznaczona dla zautomatyzowanych narzędzi, ale umożliwia również dołączanie dodatkowych obiektów, takich jak wystąpienie wyjątku i ślad stosu, do śledzenia.

Metoda TraceData wywołuje metodę ShouldTraceSourceSwitch obiektu zwróconego Switch przez właściwość . Jeśli ShouldTrace metoda zwraca truewartość , TraceData wywołuje odpowiednią TraceData metodę na wszystkich odbiornikach. TraceData W przeciwnym razie zwraca wartość bez wywoływania metod odbiorników.

Uwaga

Obiekt EventLogTraceListener jest ograniczony do maksymalnej id wartości 65 535. Jeśli określona id wartość jest większa niż 65 535, EventLogTraceListener obiekt używa wartości 65 535.