DelimitedListTraceListener.TraceEvent Methode

  • Referenz

Definition

Namespace:
System.Diagnostics
Assembly:
System.Diagnostics.TextWriterTraceListener.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Schreibt Ablaufverfolgungsinformationen für Ereignisse in eine Ausgabedatei oder einen Stream.

Überlädt

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die Ausgabedatei oder den Stream.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die Ausgabedatei oder den Stream.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Quelle:
DelimitedListTraceListener.cs
Quelle:
DelimitedListTraceListener.cs
Quelle:
DelimitedListTraceListener.cs

Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die Ausgabedatei oder den Stream.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
public override void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? message);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)

Parameter

eventCache
TraceEventCache

Ein TraceEventCache-Objekt mit der aktuellen Prozess-ID, Thread-ID und den aktuellen Stapelüberwachungsinformationen.

source
String

Ein Name, der verwendet wird, um die Ausgabe zu bezeichnen, i. d. R. der Name der Anwendung, die das Ablaufverfolgungsereignis generiert hat.

eventType
TraceEventType

Einer der TraceEventType-Werte, der den Typ des Ereignisses angibt, das die Ablaufverfolgung verursacht hat.

id
Int32

Ein numerischer Bezeichner für das Ereignis.

message
String

Die Ablaufverfolgungsmeldung, die in die Ausgabedatei oder den Stream geschrieben werden soll.

Hinweise

Die Werte der sourceParameter , eventTypeund id werden als Header geschrieben, gefolgt von den message Daten. Die eventCache Daten werden als Fußzeile geschrieben, deren Inhalt vom Wert der TraceOutputOptions Eigenschaft abhängt.

Wichtig

Die TraceEvent Methode ist nicht für den Aufruf durch Anwendungscode vorgesehen. Sie wird von Methoden der DebugKlassen , Traceund TraceSource aufgerufen, um Ablaufverfolgungsdaten zu schreiben.

Gilt für:

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Quelle:
DelimitedListTraceListener.cs
Quelle:
DelimitedListTraceListener.cs
Quelle:
DelimitedListTraceListener.cs

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die Ausgabedatei oder den Stream.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
public override void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);
public override void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parameter

eventCache
TraceEventCache

Ein TraceEventCache-Objekt mit der aktuellen Prozess-ID, Thread-ID und den aktuellen Stapelüberwachungsinformationen.

source
String

Ein Name, der verwendet wird, um die Ausgabe zu bezeichnen, i. d. R. der Name der Anwendung, die das Ablaufverfolgungsereignis generiert hat.

eventType
TraceEventType

Einer der TraceEventType-Werte, der den Typ des Ereignisses angibt, das die Ablaufverfolgung verursacht hat.

id
Int32

Ein numerischer Bezeichner für das Ereignis.

format
String

Eine Formatzeichenfolge mit 0 oder mehr Formatelementen, die Objekten im args-Array entsprechen.

args
Object[]

Ein Array mit 0 oder mehr zu formatierenden Objekten.

Hinweise

Die Werte der sourceParameter , eventTypeund id werden als Header geschrieben. Das args Objektarray wird mithilfe der String.Format(String, Object[]) -Methode in eine Zeichenfolge konvertiert, wobei die Zeichenfolge und args das format Array übergeben werden, um die Zeichenfolge als Nachrichtenteil der Ablaufverfolgung zu formatieren. Die eventCache Daten werden als Fußzeile geschrieben, deren Inhalt vom Wert der TraceOutputOptions Eigenschaft abhängt.

Wichtig

Die TraceEvent Methode ist nicht für den Aufruf durch Anwendungscode vorgesehen. Sie wird von Methoden der DebugKlassen , Traceund TraceSource aufgerufen, um Ablaufverfolgungsdaten zu schreiben.

Gilt für: