Freigeben über


TraceSource.TraceData Methode

Definition

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 -> unit
Public 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[] -> unit
Public 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.

Gilt für: