TraceSource.TraceData Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

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

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")>]
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

ConditionalAttribute

Ausnahmen

ObjectDisposedException

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.

TraceData(TraceEventType, Int32, Object[])

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")>]
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

ConditionalAttribute

Ausnahmen

ObjectDisposedException

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.