Freigeben über

XmlWriterTraceListener.TraceEvent Methode

  • Referenz

Definition

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

Schreibt Ereignisablaufverfolgungsinformationen in die Ausgabedatei oder den Datenstrom.

Überlädt

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

Schreibt Ablaufverfolgungsinformationen, eine Nachricht und Ereignisinformationen in die Datei oder den Datenstrom.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Schreibt Ablaufverfolgungsinformationen, eine formatierte Nachricht und Ereignisinformationen in die Datei oder den Datenstrom.

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

Quelle:
XmlWriterTraceListener.cs
Quelle:
XmlWriterTraceListener.cs
Quelle:
XmlWriterTraceListener.cs

Schreibt Ablaufverfolgungsinformationen, eine Nachricht und Ereignisinformationen in die Datei oder den Datenstrom.

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

Eine TraceEventCache, die die aktuelle Prozess-ID, Thread-ID und Stapelablaufverfolgungsinformationen enthält.

source
String

Der Quellname.

eventType
TraceEventType

Einer der TraceEventType Werte.

id
Int32

Ein numerischer Bezeichner für das Ereignis.

message
String

Die zu schreibende Nachricht.

Hinweise

Die Parameter eventCache, source, eventTypeund id werden in der Kopf- und Fußzeile der Ablaufverfolgung verwendet. Der parameter id wird vor dem Schreiben in eine nicht signierte ganze Zahl konvertiert, sodass ein negativer id Wert als große positive ganze Zahl geschrieben wird. Der message-Parameter wird als Message-Element geschrieben.

Wichtig

Diese Methode soll nicht direkt von Anwendungscode aufgerufen werden. Sie wird von Methoden der Debug, Traceund TraceSource Klassen aufgerufen, um Ablaufverfolgungsdaten zu schreiben.

Gilt für:

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

Quelle:
XmlWriterTraceListener.cs
Quelle:
XmlWriterTraceListener.cs
Quelle:
XmlWriterTraceListener.cs

Schreibt Ablaufverfolgungsinformationen, eine formatierte Nachricht und Ereignisinformationen in die Datei oder den Datenstrom.

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

Eine TraceEventCache, die die aktuelle Prozess-ID, Thread-ID und Stapelablaufverfolgungsinformationen enthält.

source
String

Der Quellname.

eventType
TraceEventType

Einer der TraceEventType Werte.

id
Int32

Ein numerischer Bezeichner für das Ereignis.

format
String

Eine Formatzeichenfolge, die Null- oder mehr Formatelemente enthält, die Objekten im args Array entsprechen.

args
Object[]

Ein Objektarray, das null oder mehr zu formatierende Objekte enthält.

Hinweise

Die Parameter eventCache, source, eventTypeund id werden in der Kopf- und Fußzeile der Ablaufverfolgung verwendet. Der parameter id wird vor dem Schreiben in eine nicht signierte ganze Zahl konvertiert, sodass ein negativer id Wert als große positive ganze Zahl geschrieben wird. Die String.Format(String, Object[])-Methode wird aufgerufen und übergibt die format Zeichenfolge und args Array als Parameter, um das args Objektarray als Message-Element zu formatieren.

Wichtig

Diese Methode soll nicht direkt von Anwendungscode aufgerufen werden. Sie wird von Methoden der Debug, Traceund TraceSource Klassen aufgerufen, um Ablaufverfolgungsdaten zu schreiben.

Gilt für: