EventWrittenEventArgs 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.
Stellt Daten für den OnEventWritten(EventWrittenEventArgs) Rückruf bereit.
public ref class EventWrittenEventArgs : EventArgspublic class EventWrittenEventArgs : EventArgstype EventWrittenEventArgs = class
inherit EventArgsPublic Class EventWrittenEventArgs
Inherits EventArgs- Vererbung
Hinweise
Die EventWrittenEventArgs Klasse stellt Daten für den OnEventWritten Rückruf bereit.
Wenn ein Ereignis an ein EventListener gesendet wird, wird die EventListener.OnEventWritten-Rückrufmethode aufgerufen. Es wird eine EventWrittenEventArgs Instanz übergeben, die Informationen enthält, die dem Ereignis zugeordnet sind. Alle Eigenschaftswerte der Klasse sind nur während des EventWrittenEventArgs Rückrufs gültig.
Die folgenden Abschnitte enthalten zusätzliche Informationen zu einzelnen EventWrittenEventArgs Eigenschaften.
Aktivitäts-ID-Eigenschaft
Bei Verwendung von System.Activities.Activity und den abgeleiteten Klassen können Threads als mit einer Aktivität verbunden gekennzeichnet werden. Die ActivityId Eigenschaft gibt die Aktivitäts-ID des Threads zurück, der das Ereignis protokolliert hat. Beachten Sie, dass Threads keine Aktivität aufweisen müssen, in diesem Fall gibt diese Eigenschaft zurück Guid.Empty.
OSThreadId- und TimeStamp-Eigenschaften
Ab .NET Core 2.2 EventListener können Objekte systemeigene Laufzeitereignisse (z. B. GC-, JIT- und Threadpoolereignisse) zusätzlich zu Ereignissen abonnieren, die von EventSource Objekten ausgegeben werden. In früheren Versionen von .NET Core und allen Versionen von .NET Framework kann die Thread-ID und der Zeitstempel aus der Umgebung gesammelt werden, da sie synchron auf demselben Thread verteilt werden, der sie ausgegeben hat. Nicht alle systemeigenen Laufzeitereignisse können synchron verteilt werden. Einige Ereignisse, z. B. GC-Ereignisse, werden ausgegeben, wenn die Ausführung des verwalteten Threads angehalten wird. Diese Ereignisse werden in systemeigenem Code gepuffert und von einem Dispatcherthread verteilt, sobald verwalteter Code erneut ausgeführt werden kann. Da diese Ereignisse gepuffert sind, kann die Umgebung nicht verwendet werden, um die Thread-ID und den Zeitstempel zuverlässig abzurufen. Aus diesem Grund sind thread-ID- und Zeitstempelinformationen ab .NET Core 2.2 als Member der EventWrittenEventArgs Klasse verfügbar.
RelatedActivityId-Eigenschaft
Eine verwandte Aktivität ist eine Aktivität, die stark mit dem aktuellen verknüpft ist. In der Regel handelt es sich entweder um die Aktivität, die die aktuelle Aktivität verursacht hat (Ereignisse mit dem Start-Opcode tun dies normalerweise) oder um eine Aktivität, die von der aktuellen erstellt wurde (Ereignisse mit dem Send-Opcode tun dies normalerweise). Wenn es verwendet wird, wird das RelatedActivityID explizit von der Methode, die das Logging ausführt, übergeben. Übergeben Sie nicht viele Ereignisse eine RelatedActivityId, in diesem Fall gibt diese Eigenschaft zurück Guid.Empty.
Eigenschaften
| Name | Beschreibung |
|---|---|
| ActivityId |
Ruft die Aktivitäts-ID für den Thread ab, in den das Ereignis geschrieben wurde. |
| Channel |
Ruft den Kanal für das Ereignis ab. |
| EventId |
Ruft den Ereignisbezeichner ab. |
| EventName |
Ruft den Namen des Ereignisses ab. |
| EventSource |
Ruft das Ereignisquellobjekt ab. |
| Keywords |
Ruft die Schlüsselwörter für das Ereignis ab. |
| Level |
Ruft die Ebene des Ereignisses ab. |
| Message |
Ruft die Nachricht für das Ereignis ab. |
| Opcode |
Ruft den Vorgangscode für das Ereignis ab. |
| OSThreadId |
Ruft den Threadbezeichner für den Betriebssystemthread ab, der das Ereignis geschrieben hat. (nur .NET Core 2.2 und höher.) |
| Payload |
Ruft die Nutzlast für das Ereignis ab. |
| PayloadNames |
Gibt eine Liste von Zeichenfolgen zurück, die die Eigenschaftennamen des Ereignisses darstellen. |
| RelatedActivityId |
Ruft den Bezeichner einer Aktivität ab, die mit der aktivität verknüpft ist, die durch die aktuelle Instanz dargestellt wird. |
| Tags |
Gibt die im Aufruf der Write(String, EventSourceOptions) Methode angegebenen Tags zurück. |
| Task |
Ruft die Aufgabe für das Ereignis ab. |
| TimeStamp |
Ruft die Zeit ab, zu der das Ereignis ursprünglich als DateTime Zeitstempel generiert wurde. (nur .NET Core 2.2 und höher.) |
| Version |
Ruft die Version des Ereignisses ab. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
