TraceSource.TraceData Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.TraceSource.dll

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

Přetížení

Name	Description
TraceData(TraceEventType, Int32, Object)	Zapíše data trasování do naslouchacích procesů trasování v Listeners kolekci 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 Listeners kolekci 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 Listeners kolekci 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í TraceData(TraceEventType, Int32, Object) metody k filtrování a přeposílání trasovací zprávy na naslouchacím procesům. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu 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.")

Poznámky

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

Metoda TraceData volá metodu SourceSwitch.ShouldTrace objektu SourceSwitch vráceného Switch vlastností. Pokud ShouldTrace vrátí true, TraceData volá odpovídající TraceData metodu pro všechny naslouchací procesy. TraceData V opačném případě se vrátí bez volání metod naslouchacího procesu.

Poznámka:

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

TraceData(TraceEventType, Int32, Object[])

Zdroj:

TraceSource.cs

Zapíše data trasování do naslouchacích procesů trasování v Listeners kolekci 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 , podobně jako metoda TraceEvent , je určena pro automatizované nástroje, ale také umožňuje připojení dalších objektů, jako je instance výjimky a trasování zásobníku, ke trasování.

Metoda TraceData volá metodu ShouldTrace objektu SourceSwitch vráceného Switch vlastností. Pokud ShouldTrace vrátí true, TraceData volá odpovídající TraceData metodu pro všechny naslouchací procesy. TraceData V opačném případě se vrátí bez volání metod naslouchacího procesu.

Poznámka:

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