TraceSource.TraceData Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Schrijft traceringsgegevens naar de traceerlisteners in de Listeners verzameling.
Overloads
| Name | Description |
|---|---|
| TraceData(TraceEventType, Int32, Object) |
Schrijft traceringsgegevens naar de traceerlisteners in de Listeners verzameling met behulp van het opgegeven gebeurtenistype, gebeurtenis-id en traceringsgegevens. |
| TraceData(TraceEventType, Int32, Object[]) |
Schrijft traceringsgegevens naar de traceerlisteners in de Listeners verzameling met behulp van het opgegeven gebeurtenistype, gebeurtenis-id en traceringsgegevensmatrix. |
TraceData(TraceEventType, Int32, Object)
Schrijft traceringsgegevens naar de traceerlisteners in de Listeners verzameling met behulp van het opgegeven gebeurtenistype, gebeurtenis-id en traceringsgegevens.
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 -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)Parameters
- eventType
- TraceEventType
Een van de opsommingswaarden waarmee het gebeurtenistype van de traceringsgegevens wordt opgegeven.
- id
- Int32
Een numerieke id voor de gebeurtenis.
- data
- Object
De traceringsgegevens.
- Kenmerken
Uitzonderingen
Er is een poging gedaan om een gebeurtenis te traceren tijdens het voltooien.
Voorbeelden
In het volgende codevoorbeeld ziet u het gebruik van de TraceData(TraceEventType, Int32, Object) methode voor het filteren en doorsturen van een traceringsbericht naar de listeners. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de TraceSource klasse.
// 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.")
Opmerkingen
De TraceData methode, zoals de TraceEvent methode, is bedoeld voor geautomatiseerde hulpprogramma's, maar biedt ook de mogelijkheid om een extra object, zoals een uitzonderingexemplaren, toe te voegen aan de tracering.
Met TraceData de methode wordt de SourceSwitch.ShouldTrace methode aangeroepen van het SourceSwitch object dat door de Switch eigenschap wordt geretourneerd. Als ShouldTrace deze retourneert true, TraceData wordt de bijbehorende TraceData methode voor alle listeners aangeroepen.
TraceData Anders wordt geretourneerd zonder de methoden van de listeners aan te roepen.
Note
Het EventLogTraceListener object is beperkt tot een maximumwaarde id van 65.535. Als de id opgegeven waarde groter is dan 65.535, gebruikt het EventLogTraceListener object 65.535.
Van toepassing op
TraceData(TraceEventType, Int32, Object[])
Schrijft traceringsgegevens naar de traceerlisteners in de Listeners verzameling met behulp van het opgegeven gebeurtenistype, gebeurtenis-id en traceringsgegevensmatrix.
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[] -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())Parameters
- eventType
- TraceEventType
Een van de opsommingswaarden waarmee het gebeurtenistype van de traceringsgegevens wordt opgegeven.
- id
- Int32
Een numerieke id voor de gebeurtenis.
- data
- Object[]
Een objectmatrix met de traceringsgegevens.
- Kenmerken
Uitzonderingen
Er is een poging gedaan om een gebeurtenis te traceren tijdens het voltooien.
Opmerkingen
De TraceData methode, zoals de TraceEvent methode, is bedoeld voor geautomatiseerde hulpprogramma's, maar biedt ook de mogelijkheid om extra objecten, zoals een uitzonderingsexemplaren en een stacktracering, toe te voegen aan de tracering.
Met TraceData de methode wordt de ShouldTrace methode aangeroepen van het SourceSwitch object dat door de Switch eigenschap wordt geretourneerd. Als ShouldTrace deze retourneert true, TraceData wordt de bijbehorende TraceData methode voor alle listeners aangeroepen.
TraceData Anders wordt geretourneerd zonder de methoden van de listeners aan te roepen.
Note
Het EventLogTraceListener object is beperkt tot een maximumwaarde id van 65.535. Als de id opgegeven waarde groter is dan 65.535, gebruikt het EventLogTraceListener object 65.535.