Activity Klasse

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Paket:

System.Diagnostics.DiagnosticSource v11.0.0-preview.4.26230.115

Quelle:

Activity.cs

Stellt einen für die Protokollierung zu verwendenden Vorgang mit Kontext dar.

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Vererbung

Object

Activity

Implementiert

IDisposable

Hinweise

Ein Activity Vorgangsname, eine ID, eine Startzeit und Dauer, Tags und Gepäck.

Auf die aktuelle Aktivität kann mit der statischen Activity.Current Eigenschaft zugegriffen werden.

Aktivitäten sollten durch Aufrufen des Konstruktors erstellt werden, wie erforderlich konfiguriert und dann mit der Start Methode gestartet werden, die beziehungen zwischen übergeordneten und untergeordneten Elementen für die Aktivitäten und Sätze Activity.Currentverwaltet.

Wenn eine Aktivität abgeschlossen ist, sollte sie mit der Activity.Stop() Methode beendet werden.

Wenn Sie das Activity Objekt jedoch löschen, wird es beendet, sodass Sie nicht explizit aufrufen Activity.Stop()müssen. Das vereinfacht das Codierungsmuster. Weitere Informationen finden Sie in der Dispose Methode.

Es können keine Activity Methoden ausnahmen als Reaktion auf ungültige Eingaben escapen. Sie werden ausgelöst und abgefangen (sodass Debugger und Monitore den Fehler sehen können), die Ausnahme wird jedoch unterdrückt, und der Vorgang führt etwas vernünftiges aus (in der Regel nichts).

Konstruktoren

Name	Beschreibung
Activity(String)	Initialisiert eine neue Instanz der Activity-Klasse.

Eigenschaften

Name	Beschreibung
ActivityTraceFlags	Dient zum Abrufen oder Festlegen der Flags (definiert durch die W3C-ID-Spezifikation), die der Aktivität zugeordnet sind.
Baggage	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die Informationen darstellen, die an untergeordnete Elemente dieser Eigenschaft Activityübergeben werden.
Context	Ruft den Kontext der Aktivität ab. Der Kontext wird nur gültig, wenn die Aktivität gestartet wurde.
Current	Dient zum Abrufen oder Festlegen des aktuellen Vorgangs (Activity) für den aktuellen Thread. Dies fließt über asynchrone Aufrufe.
DefaultIdFormat	Ruft ab oder legt das Standard-ID-Format für das Activity.
DisplayName	Dient zum Abrufen oder Festlegen des Anzeigenamens der Aktivität.
Duration	Ruft die Dauer des Vorgangs ab.
Events	Ruft die Liste aller Aktivitätsereignisse ab, die dieser Aktivität zugeordnet sind.
ForceDefaultIdFormat	Dient zum Abrufen oder Festlegen eines Werts, der detrmines, wenn dies DefaultIdFormat immer zum Definieren des Standard-ID-Formats verwendet wird.
HasRandomizedTraceId	Stellt einen für die Protokollierung zu verwendenden Vorgang mit Kontext dar.
HasRemoteParent	Ruft einen Wert ab, der angibt, ob der übergeordnete Kontext aus der Remoteverteilung erstellt wurde.
Id	Ruft einen Bezeichner ab, der für eine bestimmte Anforderung spezifisch ist.
IdFormat	Ruft das Format für das Id.
IsAllDataRequested	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob diese Aktivität mit allen Verteilungsinformationen sowie allen anderen Eigenschaften wie Links, Tags und Ereignissen aufgefüllt werden soll.
IsStopped	Ruft einen Wert ab, der angibt, ob dieses Activity Objekt angehalten wird oder nicht.
Kind	Ruft die Beziehung zwischen der Aktivität, den übergeordneten Elementen und den untergeordneten Elementen in einer Ablaufverfolgung ab.
Links	Ruft die Liste aller Aktivitätslinks ab, die dieser Aktivität zugeordnet sind.
OperationName	Ruft den Vorgangsnamen ab.
Parent	Ruft das übergeordnete Element Activity ab, das diese Aktivität erstellt hat.
ParentId	Ruft die ID des übergeordneten Elements dieser Aktivität ab.
ParentSpanId	Ruft die übergeordneten Elemente ab SpanId.
Recorded	Ruft einen Wert ab, der angibt, ob das Flag "W3CIdFlags.Recorded" festgelegt ist.
RootId	Ruft die Stamm-ID dieses Activity.
Source	Ruft die Aktivitätsquelle ab, die dieser Aktivität zugeordnet ist.
SpanId	Ruft den SPAN-Teil der Id.
StartTimeUtc	Ruft die Zeit ab, zu der der Vorgang gestartet wurde.
Status	Ruft den Statuscode des aktuellen Aktivitätsobjekts ab.
StatusDescription	Ruft die Statusbeschreibung des aktuellen Aktivitätsobjekts ab.
TagObjects	Ruft die Liste der Tags ab, die Informationen darstellen, die zusammen mit der Aktivität protokolliert werden sollen. Diese Informationen werden nicht an die untergeordneten Elemente dieser Aktivität weitergegeben.
Tags	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die Informationen darstellen, die zusammen mit dem Activity Protokollierungssystem protokolliert werden.
TraceId	Ruft den TraceId-Teil der Id.
TraceIdGenerator	Beim Starten einer Aktivität, die keinen übergeordneten Kontext aufweist, wird die Ablaufverfolgungs-ID automatisch mithilfe von Zufallszahlen generiert. TraceIdGenerator kann verwendet werden, um den standardmäßigen Ablaufverfolgungs-ID-Generierungsalgorithmus der Laufzeit außer Kraft zu setzen.
TraceStateString	Dient zum Abrufen oder Festlegen des W3C-Headers tracestate .

Methoden

Name	Beschreibung
AddBaggage(String, String)	Aktualisiert, Activity dass ein neuer Gepäckartikel mit dem angegebenen Schlüssel und Wert enthalten ist.
AddEvent(ActivityEvent)	Fügt der Ereignisliste das angegebene Aktivitätsereignis hinzu.
AddException(Exception, TagList, DateTimeOffset)	Fügen Sie der Liste ein ActivityEvent Objekt hinzu, das Events die Ausnahmeinformationen enthält.
AddLink(ActivityLink)	Fügt der Links Liste eine ActivityLink hinzu.
AddTag(String, Object)	Aktualisiert die Aktivität so, dass ein Tag mit einer zusätzlichen key und value.
AddTag(String, String)	Aktualisiert das Activity neue Tag mit dem bereitgestellten key und value.
Dispose()	Beendet die Aktivität, wenn sie bereits gestartet wurde, und benachrichtigt alle Ereignislistener. Andernfalls geschieht nichts.
Dispose(Boolean)	Wenn diese Methode von einem abgeleiteten Typ überschrieben wird, werden alle zugeordneten Ressourcen freigegeben.
EnumerateEvents()	Listet die Objekte auf, die ActivityEvent diesem Activity-Objekt zugeordnet sind.
EnumerateLinks()	Listet die Objekte auf, die ActivityLink diesem Activity-Objekt zugeordnet sind.
EnumerateTagObjects()	Listet die Tags auf, die diesem Activity-Objekt zugeordnet sind.
GetBaggageItem(String)	Gibt den Wert eines Schlüsselwertpaars zurück, das der Aktivität hinzugefügt wird.AddBaggage(String, String)
GetCustomProperty(String)	Gibt das Objekt zurück, das dem angegebenen Eigenschaftennamen zugeordnet ist.
GetTagItem(String)	Gibt den Wert des Aktivitätstags zurück, das dem Eingabeschlüssel zugeordnet ist. Gibt zurück null , wenn dieser Schlüssel nicht vorhanden ist.
SetBaggage(String, String)	Fügen Sie das Aktivitätsgepäck mit dem Eingabeschlüssel und dem Wert hinzu, oder aktualisieren Sie es. Wenn der Eingabewert lautet null – wenn die Abholung Gepäck mit demselben Schlüssel hat, wird dieses Gepäck aus der Sammlung entfernt. - andernfalls geschieht nichts, und die Sammlung ändert sich nicht. Wenn der Eingabewert nicht null lautet – wenn die Sammlung Gepäck mit demselben Schlüssel hat, wird der diesem Schlüssel zugeordnete Wert mit dem neuen Eingabewert aktualisiert. - andernfalls wird der Schlüssel und der Wert als neues Gepäck zur Sammlung hinzugefügt. Gepäckartikel wird nur aktualisiert/entfernt, wenn es der aktuellen Aktivität ursprünglich hinzugefügt wurde. Von den Eltern geerbte Elemente werden nicht geändert/entfernt, stattdessen wird dem aktuellen Aktivitätsgepäck ein neues Element hinzugefügt.
SetCustomProperty(String, Object)	Fügt jedes benutzerdefinierte Objekt an diese Aktivität an. Wenn das angegebene propertyName Objekt zuvor einem anderen Objekt zugeordnet war, wird die Eigenschaft aktualisiert, damit sie stattdessen dem neuen propertyValue zugeordnet wird. Es wird empfohlen, einen eindeutigen Eigenschaftsnamen zu verwenden, um Konflikte mit jedem zu vermeiden, der denselben Wert verwendet.
SetEndTime(DateTime)	Aktualisiert den Activity Wert, um den Wert als Unterschied zwischen Duration und der angegebenen Stoppzeit festzulegenStartTimeUtc.
SetIdFormat(ActivityIdFormat)	Legt das ID-Format dafür Activity fest, bevor es gestartet wird.
SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)	Legt die übergeordnete ID mithilfe der W3C-Konvention einer TraceId und einer SpanId fest.
SetParentId(String)	Aktualisiert dies Activity , um anzugeben, dass die Activity MIT einer ID, die parentId dies Activityverursacht hat.
SetStartTime(DateTime)	Legt die Startzeit dieses Werts Activityfest.
SetStatus(ActivityStatusCode, String)	Legt den Statuscode und die Beschreibung für das aktuelle Aktivitätsobjekt fest.
SetTag(String, Object)	Fügt das Aktivitätstag mit dem Eingabeschlüssel und -wert hinzu oder aktualisiert es.
Start()	Startet die Aktivität.
Stop()	Beendet die Aktivität.

Ereignisse

Name	Beschreibung
CurrentChanged	Tritt auf, wenn sich der Current Wert ändert.