EventLogTraceListener.TraceData Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- Quelle:
- EventLogTraceListener.cs
- 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 -> unitPublic 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
Ausnahmen
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.
Gilt für:
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])
- Quelle:
- EventLogTraceListener.cs
- Quelle:
- EventLogTraceListener.cs
- 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[] -> unitPublic 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
Ausnahmen
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.
