DelimitedListTraceListener.TraceEvent 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 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)
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 -> unitPublic 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[])
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[] -> unitPublic 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.
