FileLogTraceListener.TraceEvent Methode

Definition

Namespace:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

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

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType

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

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType