Freigeben über


FileLogTraceListener.TraceEvent Methode

Definition

Schreibt Ablaufverfolgungs- und Ereignisdaten in die Ausgabedatei oder den Ausgabestream.

Ü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.

Hinweise

TraceEvent -Methoden sollen nicht vom Anwendungscode aufgerufen werden. Diese Methoden werden von Membern der DebugKlassen , Traceund TraceSource aufgerufen, um Ablaufverfolgungsdaten in die Ausgabe zu schreiben.

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);
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

Der Name der Ablaufverfolgungsquelle, die diese Methode aufgerufen hat.

eventType
TraceEventType

Einer der TraceEventType-Enumerationswerte.

id
Int32

Ein numerischer Bezeichner für das Ereignis.

message
String

Eine zu schreibende Meldung.

Hinweise

Diese Methode:

  1. Formatiert die Daten- und Kontextinformationen für die Ausgabe.

  2. Erstellt bei Bedarf eine neue Protokolldatei.

  3. Schreibt die Informationen in die Protokolldatei.

Weitere Informationen zum Erstellen neuer Protokolldateien finden Sie unter FullLogFileName.

In dieser Tabelle werden die Ausgabefelder in der Reihenfolge aufgelistet, in der sie angezeigt werden. Die Felder werden durch die von der Delimiter -Eigenschaft angegebene Zeichenfolge getrennt, gefolgt von einem Zeilenabschlusszeichen.

Feld Ausgabebedingung Beschreibung
source Immer Der Wert von name.
severity Immer Der Enumerationswertname von eventType.
id Immer Eine Zeichenfolgendarstellung von id.
message Immer Der Wert von message.
callStack Wenn das Callstack Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die Callstack -Eigenschaft von eventCache.
CorrelationID Wenn das LogicalOperationStack Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die ThreadId -Eigenschaft von eventCache.
DateTime Wenn das DateTime Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die Zeichenfolgendarstellung der DateTime -Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
ProcessID Wenn das ProcessId Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die Zeichenfolgendarstellung der ProcessId -Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
ThreadID Wenn das ThreadId Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die ThreadId -Eigenschaft von eventCache.
Timestamp Wenn das Timestamp Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die Zeichenfolgendarstellung der Timestamp -Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
HostName Wenn die IncludeHostName -Eigenschaft ist True. Der Name des Computers.

Weitere Informationen

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);
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

Der Name der Ablaufverfolgungsquelle, die diese Methode aufgerufen hat.

eventType
TraceEventType

Einer der TraceEventType-Enumerationswerte.

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 Object-Array mit 0 oder mehr zu formatierenden Objekten.

Hinweise

Diese Methode:

  1. Formatiert die Daten- und Kontextinformationen für die Ausgabe.

  2. Erstellt bei Bedarf eine neue Protokolldatei.

  3. Schreibt die Informationen in die Protokolldatei.

Weitere Informationen zum Erstellen einer neuen Protokolldatei finden Sie unter FullLogFileName.

In dieser Tabelle werden die Ausgabefelder in der Reihenfolge aufgelistet, in der sie angezeigt werden. Die Felder werden durch die von der Delimiter -Eigenschaft angegebene Zeichenfolge und gefolgt von einem Zeilenabschlusszeichen getrennt.

Feld Ausgabebedingung Beschreibung
source Always Der Wert von name.
severity Always Der Enumerationswertname von eventType.
id Always Eine Zeichenfolgendarstellung von id.
message Always Die Mit der format Zeichenfolge formatierten Datenargs, die die invariante Kultur für Zeichenfolgenkonvertierungen verwenden.
callStack Wenn das Callstack Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die Callstack -Eigenschaft von eventCache.
CorrelationID Wenn das LogicalOperationStack Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die ThreadId -Eigenschaft von eventCache.
DateTime Wenn das DateTime Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die Zeichenfolgendarstellung der DateTime -Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
ProcessID Wenn das ProcessId Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die Zeichenfolgendarstellung der ProcessId -Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
ThreadID Wenn das ThreadId Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die ThreadId -Eigenschaft von eventCache.
Timestamp Wenn das Timestamp Flag in der TraceOutputOptions -Eigenschaft festgelegt ist. Die Zeichenfolgendarstellung der Timestamp -Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
HostName Wenn die IncludeHostName -Eigenschaft ist True. Der Name des Computers.

Weitere Informationen

Gilt für: