TraceSource.TraceData Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.TraceSource.dll

Zapíše data trasování do naslouchacích procesů trasování v kolekci Listeners .

Přetížení

TraceData(TraceEventType, Int32, Object)	Zapíše data trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události, identifikátoru události a dat trasování.
TraceData(TraceEventType, Int32, Object[])	Zapíše data trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události, identifikátoru události a pole dat trasování.

TraceData(TraceEventType, Int32, Object)

Zdroj:

TraceSource.cs

Zapíše data trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události, identifikátoru události a dat trasování.

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 hodnot výčtu, která určuje typ události dat trasování.

id

Int32

Číselný identifikátor události.

data

Object

Data trasování.

Atributy

ConditionalAttribute

Výjimky

ObjectDisposedException

Během finalizace došlo k pokusu o trasování události.

Příklady

Následující příklad kódu ukazuje použití metody k filtrování a předání zprávy trasování naslouchacím TraceData(TraceEventType, Int32, Object) procesům. Tento příklad kódu je součástí většího příkladu TraceSource pro třídu.

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

Poznámky

Metoda TraceData , stejně jako TraceEvent metoda, je určená pro automatizované nástroje, ale umožňuje také připojení dalšího objektu, například instance výjimky, k trasování.

Metoda TraceData volá metodu SourceSwitch.ShouldTrace objektu SourceSwitch vrácenou Switch vlastností. Pokud ShouldTrace vrátí true, TraceData zavolá odpovídající TraceData metodu ve všech naslouchacích procesech. V opačném TraceData případě se vrátí bez volání metod naslouchacích procesů.

Poznámka

Objekt EventLogTraceListener je omezen na maximální id hodnotu 65 535. id Pokud je zadaná hodnota větší než 65 535, EventLogTraceListener objekt použije 65 535.

TraceData(TraceEventType, Int32, Object[])

Zdroj:

TraceSource.cs

Zapíše data trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události, identifikátoru události a pole dat trasování.

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 hodnot výčtu, která určuje typ události dat trasování.

id

Int32

Číselný identifikátor události.

data

Object[]

Pole objektů obsahující data trasování.

Atributy

ConditionalAttribute

Výjimky

ObjectDisposedException

Během finalizace došlo k pokusu o trasování události.

Poznámky

Metoda TraceData , stejně jako TraceEvent metoda, je určená pro automatizované nástroje, ale umožňuje také připojení dalších objektů, jako je instance výjimky a trasování zásobníku, k trasování.

Metoda TraceData volá metodu ShouldTrace objektu SourceSwitch vrácenou Switch vlastností. Pokud ShouldTrace vrátí true, TraceData zavolá odpovídající TraceData metodu ve všech naslouchacích procesech. V opačném TraceData případě se vrátí bez volání metod naslouchacích procesů.

Poznámka

Objekt EventLogTraceListener je omezen na maximální id hodnotu 65 535. id Pokud je zadaná hodnota větší než 65 535, EventLogTraceListener objekt použije 65 535.