EventLogTraceListener.TraceEvent Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Schreibt Ablaufverfolgungsinformationen in das Ereignisprotokoll.

Überlädt

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in das Ereignisprotokoll.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Schreibt Ablaufverfolgungsinformationen, ein formatiertes Objektarray und Ereignisinformationen in das Ereignisprotokoll.

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

Quelle:

EventLogTraceListener.cs

Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in das Ereignisprotokoll.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

Parameter

eventCache

TraceEventCache

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

severity

TraceEventType

Einer der Enumerationswerte, der den Ereignistyp des Ereignisses angibt, das die Ablaufverfolgung angibt.

id

Int32

Ein numerischer Bezeichner für das Ereignis. Die Kombination von source und id bezeichnet ein Ereignis eindeutig.

message

String

Die Ablaufverfolgungsmeldung.

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentException

source ist nicht angegeben.

- oder -

Die Protokolleintragszeichenfolge überschreitet 32.766 Zeichen.

Hinweise

Wichtig

Die TraceEvent Methoden sollen nicht vom Anwendungscode aufgerufen werden. Diese Methoden werden von Methoden der DebugKlassen , Traceund TraceSource aufgerufen, um Ablaufverfolgungsdaten zu schreiben.

Die TraceEvent -Methode dient der Nachverfolgung von Ereignissen, die von Tools automatisch verarbeitet werden können. Beispielsweise kann ein Überwachungstool einen Administrator benachrichtigen, wenn ein bestimmtes Ereignis von einer bestimmten Quelle nachverfolgt wird.

Die eventCache Parameter und source werden verwendet, um zu bestimmen, ob das Ereignis nachverfolgt werden soll. id wird verwendet, um ein EventInstance -Objekt zu erstellen, und der TraceEventType wird mit einem EventLogEntryType für die EntryType -Eigenschaft gleichgesetzt. Wird EventInstance mit den message Daten mithilfe der -Methode in das WriteEvent Ereignisprotokoll geschrieben.

Hinweis

Der Maximalwert des id Parameters ist 65.535. Wenn der id angegebene Wert größer als 65.535 ist, wird der Maximalwert verwendet.

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

Quelle:

EventLogTraceListener.cs

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Objektarray und Ereignisinformationen in das Ereignisprotokoll.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parameter

eventCache

TraceEventCache

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

severity

TraceEventType

Einer der Enumerationswerte, der den Ereignistyp des Ereignisses angibt, das die Ablaufverfolgung angibt.

id

Int32

Ein numerischer Bezeichner für das Ereignis. Die Kombination von source und id bezeichnet ein Ereignis eindeutig.

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.

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentException

source ist nicht angegeben.

- oder -

Die Protokolleintragszeichenfolge überschreitet 32.766 Zeichen.

Hinweise

Wichtig

Die TraceEvent Methoden sollen nicht vom Anwendungscode aufgerufen werden. Diese Methoden werden von Methoden der DebugKlassen , Traceund TraceSource aufgerufen, um Ablaufverfolgungsdaten zu schreiben.

Die TraceEvent -Methode dient der Nachverfolgung von Ereignissen, die von Tools automatisch verarbeitet werden können. Beispielsweise kann ein Überwachungstool einen Administrator benachrichtigen, wenn ein bestimmtes Ereignis von einer bestimmten Quelle nachverfolgt wird.

Die eventCache Parameter und source werden verwendet, um zu bestimmen, ob das Ereignis nachverfolgt werden soll. id wird verwendet, um ein EventInstance -Objekt zu erstellen, und der TraceEventType wird mit einem EventLogEntryType für die EntryType -Eigenschaft gleichgesetzt. Wird EventInstance mit der -Methode in das WriteEvent Ereignisprotokoll geschrieben, wobei die Nachricht aus den format Parametern und args abgerufen wird. Das args Objektarray wird mithilfe der Format -Methode in eine Zeichenfolge konvertiert, wobei die Zeichenfolge und args das format Array übergeben werden, um die Zeichenfolge als Meldung für das Ereignisprotokoll zu formatieren.

Hinweis

Der Maximalwert des id Parameters ist 65.535. Wenn der id angegebene Wert größer als 65.535 ist, wird der Maximalwert verwendet.