FileLogTraceListener.TraceEvent Methode

Definition

Namespace:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

Schreibt Ablaufverfolgungs- und Ereignisinformationen in die Ausgabedatei oder den Datenstrom.

Überlädt

Name	Beschreibung
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Schreibt Ablaufverfolgungsinformationen, eine Nachricht und Ereignisinformationen in die Ausgabedatei oder den Datenstrom.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die Ausgabedatei oder den Datenstrom.

Hinweise

TraceEvent Methoden sollen nicht vom Anwendungscode aufgerufen werden. Diese Methoden werden von Membern des Debug, Traceund TraceSource Klassen aufgerufen, um Ablaufverfolgungsdaten in die Ausgabe zu schreiben.

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

Quelle:

FileLogTraceListener.vb

Schreibt Ablaufverfolgungsinformationen, eine Nachricht und Ereignisinformationen in die Ausgabedatei 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);

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, das die aktuelle Prozess-ID, Thread-ID und Stapelablaufverfolgungsinformationen enthält.

source

String

Ein 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 Nachricht.

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 sind die Ausgabefelder in der Reihenfolge aufgeführt, in der sie angezeigt werden. Die Felder werden durch die von der Delimiter Eigenschaft angegebene Zeichenfolge getrennt und folgen einem Zeilenterminator.

Feld	Ausgabebedingung	Beschreibung
source	Immer.	Der Wert von name.
severity	Immer.	Der Enumerationswertname von eventType.
id	Immer.	Die Zeichenfolgendarstellung von id.
message	Immer.	Der Wert von message.
callStack	Wenn die Callstack Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die Callstack Eigenschaft von eventCache.
CorrelationID	Wenn die LogicalOperationStack Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die ThreadId Eigenschaft von eventCache.
DateTime	Wenn die DateTime Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die Zeichenfolgendarstellung der DateTime Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
ProcessID	Wenn die ProcessId Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die Zeichenfolgendarstellung der ProcessId Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
ThreadID	Wenn die ThreadId Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die ThreadId Eigenschaft von eventCache.
Timestamp	Wenn die Timestamp Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	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[])

Quelle:

FileLogTraceListener.vb

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die Ausgabedatei 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);

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, das die aktuelle Prozess-ID, Thread-ID und Stapelablaufverfolgungsinformationen enthält.

source

String

Ein 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, die Null- oder mehr Formatelemente enthält, die Objekten im args Array entsprechen.

args

Object[]

Ein Object Array, das null oder mehr Zu formatierende Objekte enthält.

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 sind die Ausgabefelder in der Reihenfolge aufgeführt, in der sie angezeigt werden. Die Felder werden durch die Zeichenfolge getrennt, die von der Delimiter Eigenschaft angegeben wird, und gefolgt von einem Zeilenterminator.

Feld	Ausgabebedingung	Beschreibung
source	Immer	Der Wert von name.
severity	Immer	Der Enumerationswertname von eventType.
id	Immer	Die Zeichenfolgendarstellung von id.
message	Immer	Die Mit der format Zeichenfolge formatierten Daten args und verwenden die invariante Kultur für Zeichenfolgenkonvertierungen.
callStack	Wenn die Callstack Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die Callstack Eigenschaft von eventCache.
CorrelationID	Wenn die LogicalOperationStack Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die ThreadId Eigenschaft von eventCache.
DateTime	Wenn die DateTime Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die Zeichenfolgendarstellung der DateTime Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
ProcessID	Wenn die ProcessId Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die Zeichenfolgendarstellung der ProcessId Eigenschaft von eventCache. Die invariante Kultur wird für die Zeichenfolgenkonvertierung verwendet.
ThreadID	Wenn die ThreadId Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	Die ThreadId Eigenschaft von eventCache.
Timestamp	Wenn die Timestamp Kennzeichnung in der TraceOutputOptions Eigenschaft festgelegt wird.	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