TraceSource.TraceData Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- Zdroj:
- TraceSource.cs
- 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")]
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
Výjimky
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.
Platí pro
TraceData(TraceEventType, Int32, Object[])
- Zdroj:
- TraceSource.cs
- Zdroj:
- TraceSource.cs
- 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")]
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
Výjimky
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.