EventLogTraceListener.TraceData Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Schreibt Ablaufverfolgungsdaten in das Ereignisprotokoll.

Überlädt

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in das Ereignisprotokoll.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in das Ereignisprotokoll.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Quelle:

EventLogTraceListener.cs

Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in das Ereignisprotokoll.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

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

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

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data 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.

data

Object

Ein Datenobjekt, das in die Ausgabedatei oder den Stream geschrieben werden soll.

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentException

source ist nicht angegeben.

- oder -

Die Protokolleintragszeichenfolge überschreitet 32.766 Zeichen.

Hinweise

Wichtig

Die TraceData Methoden sollen nicht vom Anwendungscode aufgerufen werden. Sie werden von Methoden der DebugKlassen , Traceund TraceSource aufgerufen, um Ablaufverfolgungsdaten auszugeben.

Die TraceData -Methode ist wie die TraceEvent -Methode für automatisierte Tools vorgesehen, ermöglicht aber auch das Anfügen zusätzlicher Objekte, z. B. einer Ausnahme instance, an die Ablaufverfolgung.

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 dem -Objekt, das data als Zeichenfolge formatiert ist, 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.

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

Quelle:

EventLogTraceListener.cs

Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in das Ereignisprotokoll.

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

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

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

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data 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.

data

Object[]

Ein Array von Datenobjekten.

Attribute

ComVisibleAttribute

Ausnahmen

ArgumentException

source ist nicht angegeben.

- oder -

Die Protokolleintragszeichenfolge überschreitet 32.766 Zeichen.

Hinweise

Wichtig

Die TraceData Methoden sollen nicht vom Anwendungscode aufgerufen werden. Sie werden von Methoden der DebugKlassen , Traceund TraceSource aufgerufen, um Ablaufverfolgungsdaten auszugeben.

Die TraceData -Methode ist wie die TraceEvent -Methode für automatisierte Tools vorgesehen, ermöglicht aber auch das Anfügen zusätzlicher Objekte, z. B. einer Ausnahme instance, an die Ablaufverfolgung.

Die severity Parameterdaten und id werden verwendet, um ein EventInstance -Objekt zu erstellen, das mit den Daten aus dem Array von Datenobjekten in das Ereignisprotokoll geschrieben 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 Ereignisprotokoll mit dem data Objektarray geschrieben, das WriteEvent als Zeichenfolgenarray formatiert ist.

Hinweis

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