EventProvider Klasse
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.
Verwenden Sie diese Klasse zum Schreiben von Ereignissen.
public ref class EventProvider : IDisposable
public class EventProvider : IDisposable
type EventProvider = class
interface IDisposable
Public Class EventProvider
Implements IDisposable
- Vererbung
-
EventProvider
- Implementiert
Hinweise
Zum Nutzen von Ereignissen, die mit den WriteEvent Methoden und WriteTransferEvent geschrieben wurden, müssen die Ereignisse in einem Manifest definiert werden. Ereignisse, die mit der WriteMessageEvent -Methode geschrieben werden, erfordern kein Manifest.
Ereignisse können die folgenden verwalteten Datentypen enthalten:
bool
Boolean
byte
char
Decimal
double
float
Guid
INT
IntPtr
long
sbyte
short
Zeichenfolge
uint
UInt64
Wenn ein Ereignis in Ihrem Manifest den Boolean
Typ verwendet, können Sie das Datenelement nicht mithilfe eines Boolean
Datentyps in Ihren verwalteten Code schreiben. Der Boolean
Typ in Ihrem Manifest erwartet einen 4-Byte-Wert, und ein Boolean
Datentyp im verwalteten Code ist 1-Byte. Stattdessen müssen Sie einen int
Datentyp verwenden, um den Wert zu schreiben. Wenn Sie einen Boolean
Wert protokollieren möchten, verwenden Sie den Typ UInt8 in Ihrem Manifest.
Konstruktoren
EventProvider(Guid) |
Initialisiert eine neue Instanz der EventProvider-Klasse. |
Methoden
Close() |
Entfernt die Registrierung des Anbieters aus dem ETW-Subsystem und gibt alle nicht verwalteten Ressourcen frei. |
CreateActivityId() |
Erstellt einen eindeutigen Aktivitätsbezeichner für den Anbieter. |
Dispose() |
Gibt die von diesem EventProvider-Objekt verwendeten Ressourcen frei. |
Dispose(Boolean) |
Gibt die von diesem EventProvider-Objekt verwendeten Ressourcen frei. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
Finalize() |
Gibt Ressourcen frei und führt eine interne Bereinigung durch, bevor die Instanz durch die Garbage Collection wieder freigegeben wird. |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetLastWriteEventError() |
Ruft den letzten Fehler ab, der einem Ereignis zugeordnet ist, das nicht geschrieben werden konnte. |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
IsEnabled() |
Bestimmt, ob der Anbieter durch eine Sitzung aktiviert wurde, unabhängig vom Ebenen- und Schlüsselwortwert, die zum Aktivieren des Anbieters verwendet werden. |
IsEnabled(Byte, Int64) |
Bestimmt, ob eine Sitzung das angegebene Ereignis vom Anbieter anfordert. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
SetActivityId(Guid) |
Legt den aktuellen Aktivitätsbezeichner fest, der von den WriteEvent-Methoden verwendet wird. |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
WriteEvent(EventDescriptor, Int32, IntPtr) |
Schreibt ein Ereignis. Die Ereignisdaten werden als Speicherblock angegeben. |
WriteEvent(EventDescriptor, Object[]) |
Schreibt ein Ereignis. Die Ereignisdaten werden als Objektarray angegeben. |
WriteEvent(EventDescriptor, String) |
Schreibt ein Ereignis. Die Ereignisdaten werden als Zeichenfolge angegeben. |
WriteMessageEvent(String) |
Schreibt ein Ereignis, das als Daten eine Zeichenfolge enthält. |
WriteMessageEvent(String, Byte, Int64) |
Schreibt ein Ereignis, das als Daten eine Zeichenfolge enthält, wenn der Ebenen- und Schlüsselwortwert mit den von der Sitzung angeforderten Ereignissen übereinstimmen. |
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr) |
Verknüpft Ereignisse, wenn Ereignisse in einem End-to-End-Szenario nachverfolgt werden. Die Ereignisdaten werden als Speicherblock angegeben. |
WriteTransferEvent(EventDescriptor, Guid, Object[]) |
Verknüpft Ereignisse, wenn Ereignisse in einem End-to-End-Szenario nachverfolgt werden. Die Ereignisdaten werden als Objektarray angegeben. |