DelimitedListTraceListener.TraceEvent Methode

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)

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 source, , und id parameter werden als Kopfzeile geschrieben, gefolgt von den message eventTypeDaten. Die eventCache Daten werden als Fußzeile geschrieben, deren Inhalt vom Wert der TraceOutputOptions Eigenschaft abhängt.

Wichtig

Die TraceEvent Methode soll nicht von Anwendungscode aufgerufen werden. Es wird durch Methoden der Methoden Trace, Debugund TraceSource Klassen aufgerufen, um Ablaufverfolgungsdaten zu schreiben.

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[] -> 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 source, eventType, und id Parameter werden als Kopfzeile geschrieben. Das args Objektarray wird mithilfe der String.Format(String, Object[]) Methode in eine Zeichenfolge konvertiert, die Zeichenfolge und args das Array übergeben, um die format 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 soll nicht von Anwendungscode aufgerufen werden. Es wird durch Methoden der Methoden Trace, Debugund TraceSource Klassen aufgerufen, um Ablaufverfolgungsdaten zu schreiben.