TraceSource.TraceData Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schreibt Ablaufverfolgungsdaten in die Ablaufverfolgungslistener der Listeners-Auflistung.
Überlädt
| TraceData(TraceEventType, Int32, Object) |
Schreibt Ablaufverfolgungsdaten in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner und die angegebenen Ablaufverfolgungsdaten verwendet. |
| TraceData(TraceEventType, Int32, Object[]) |
Schreibt Ablaufverfolgungsdaten in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner und das Array von Ablaufverfolgungsdaten verwendet. |
TraceData(TraceEventType, Int32, Object)
- Quelle:
- TraceSource.cs
- Quelle:
- TraceSource.cs
- Quelle:
- TraceSource.cs
Schreibt Ablaufverfolgungsdaten in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner und die angegebenen Ablaufverfolgungsdaten verwendet.
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 -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)Parameter
- eventType
- TraceEventType
Einer der Enumerationswerte, der den Ereignistyp der Ablaufverfolgungsdaten angibt.
- id
- Int32
Ein numerischer Bezeichner für das Ereignis.
- data
- Object
Die Ablaufverfolgungsdaten.
- Attribute
Ausnahmen
Es wurde versucht, während des Abschlusses ein Ereignis nachzuverfolgen.
Beispiele
Das folgende Codebeispiel zeigt die Verwendung der TraceData(TraceEventType, Int32, Object) -Methode zum Filtern und Weiterleiten einer Ablaufverfolgungsnachricht an die Listener. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TraceSource-Klasse bereitgestellt wird.
// 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.")
Hinweise
Die TraceData -Methode ist wie die TraceEvent -Methode für automatisierte Tools vorgesehen, ermöglicht aber auch das Anfügen eines zusätzlichen Objekts, z. B. einer Ausnahme instance, an die Ablaufverfolgung.
Die TraceData -Methode ruft die SourceSwitch.ShouldTrace -Methode des -Objekts auf, das SourceSwitch von der Switch -Eigenschaft zurückgegeben wird. Wenn ShouldTrace zurückgegeben wird true, TraceData ruft die entsprechende TraceData Methode für alle Listener auf. Andernfalls wird zurückgegeben, TraceData ohne die Methoden der Listener aufzurufen.
Hinweis
Das EventLogTraceListener Objekt ist auf einen Maximalwert id von 65.535 beschränkt. Wenn der id angegebene Wert größer als 65.535 ist, verwendet das EventLogTraceListener Objekt 65.535.
Gilt für:
TraceData(TraceEventType, Int32, Object[])
- Quelle:
- TraceSource.cs
- Quelle:
- TraceSource.cs
- Quelle:
- TraceSource.cs
Schreibt Ablaufverfolgungsdaten in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner und das Array von Ablaufverfolgungsdaten verwendet.
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[] -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())Parameter
- eventType
- TraceEventType
Einer der Enumerationswerte, der den Ereignistyp der Ablaufverfolgungsdaten angibt.
- id
- Int32
Ein numerischer Bezeichner für das Ereignis.
- data
- Object[]
Ein Objektarray, das die Ablaufverfolgungsdaten enthält.
- Attribute
Ausnahmen
Es wurde versucht, während des Abschlusses ein Ereignis nachzuverfolgen.
Hinweise
Die TraceData -Methode ist wie die TraceEvent -Methode für automatisierte Tools vorgesehen, ermöglicht aber auch das Anfügen zusätzlicher Objekte, z. B. einer Ausnahme instance und einer Stapelablaufverfolgung, an die Ablaufverfolgung.
Die TraceData -Methode ruft die ShouldTrace -Methode des -Objekts auf, das SourceSwitch von der Switch -Eigenschaft zurückgegeben wird. Wenn ShouldTrace zurückgegeben wird true, TraceData ruft die entsprechende TraceData Methode für alle Listener auf. Andernfalls wird zurückgegeben, TraceData ohne die Methoden der Listener aufzurufen.
Hinweis
Das EventLogTraceListener Objekt ist auf einen Maximalwert id von 65.535 beschränkt. Wenn der id angegebene Wert größer als 65.535 ist, verwendet das EventLogTraceListener Objekt 65.535.
