EventLogTraceListener.TraceData Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Assembly:

System.dll

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)

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

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, 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)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, 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)

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType 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.

severityeventType

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 Debug, Traceund TraceSource Klassen aufgerufen, um Ablaufverfolgungsdaten auszugeben.

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

Die eventCache Parameter source werden verwendet, um festzustellen, ob das Ereignis nachverfolgt werden soll. id wird verwendet, um ein EventInstance Objekt zu erstellen, und die TraceEventType wird mit einer EventLogEntryType für die EntryType Eigenschaft gleichgesetzt. Das EventInstance wird mit der Methode in das Ereignisprotokoll mit dem data Objekt geschrieben, das als Zeichenfolge WriteEvent formatiert ist.

Hinweis

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

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

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

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, 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)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, 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())

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType 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.

severityeventType

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 Debug, Traceund TraceSource Klassen aufgerufen, um Ablaufverfolgungsdaten auszugeben.

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

Die severity Daten und id Parameter werden verwendet, um ein EventInstance Objekt zu erstellen, das in das Ereignisprotokoll mit den Daten aus dem Array von Datenobjekten geschrieben wird.

Die eventCache Parameter source werden verwendet, um festzustellen, ob das Ereignis nachverfolgt werden soll. id wird verwendet, um ein EventInstance Objekt zu erstellen, und die TraceEventType wird mit einer EventLogEntryType für die EntryType Eigenschaft gleichgesetzt. Das EventInstance wird mit der Methode in das Ereignisprotokoll mit dem data Objektarray geschrieben, das als Zeichenfolgenarray WriteEvent formatiert ist.

Hinweis

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