Udostępnij za pośrednictwem


TraceSource.TraceData Metoda

Definicja

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
Źródło:
TraceSource.cs
Ź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")]
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

Wyjątki

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.

Dotyczy

TraceData(TraceEventType, Int32, Object[])

Źródło:
TraceSource.cs
Źródło:
TraceSource.cs
Ź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")]
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

Wyjątki

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.

Dotyczy