Activity Classe

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Paquet:

System.Diagnostics.DiagnosticSource v9.0.0-preview.3.24172.9

Source:

Activity.cs

Représente une opération avec le contexte à utiliser pour la journalisation.

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Héritage

Object

Activity

Implémente

IDisposable

Remarques

Un Activity a un nom d’opération, un ID, une heure de début et une durée, des étiquettes et des bagages.

L’activité actuelle est accessible avec la propriété statique Activity.Current .

Les activités doivent être créées en appelant le constructeur, configurées si nécessaire, puis démarrées avec la Start méthode, qui gère les relations parent-enfant pour les activités et définit Activity.Current.

Lorsqu’une activité est terminée, elle doit être arrêtée avec la Activity.Stop() méthode .

Toutefois, si vous supprimez l’objet Activity , cela l’arrête afin que vous n’ayez pas besoin d’appeler Activity.Stop()explicitement . Cela simplifie le modèle de codage. Pour plus d'informations, voir la méthode Dispose.

Aucune méthode n’autorise Activity les exceptions à s’échapper en réponse à des entrées incorrectes. Elles sont levées et interceptées (ce qui permet aux débogueurs et aux moniteurs de voir l’erreur), mais l’exception est supprimée et l’opération fait quelque chose de raisonnable (généralement, elle ne fait rien).

Constructeurs

Activity(String)

Initialise une nouvelle instance de la classe Activity.

Propriétés

ActivityTraceFlags	Obtient ou défnit les indicateurs (définis par la spécification d’ID de W3C) associés à l’activité.
Baggage	Obtient une collection de paires clé-valeur qui représentent les informations passées aux enfants de ce Activity.
Context	Obtient le contexte de l’activité. Le contexte devient valide uniquement si l’activité a été démarrée.
Current	Obtient ou définit l’opération en cours (Activity) pour le thread actuel. Cela s’effectue par le biais d’appels asynchrones.
DefaultIdFormat	Obtient ou définit le format d’ID par défaut pour la Activity.
DisplayName	Obtient ou définit le nom d’affichage de l’activité.
Duration	Obtient la durée de l’opération.
Events	Obtient la liste de tous les événements d’activité attachés à cette activité.
ForceDefaultIdFormat	Obtient ou définit une valeur qui détermine si le DefaultIdFormat est toujours utilisé pour définir le format d’ID par défaut.
HasRemoteParent	Obtient une valeur qui indique si le contexte parent a été créé à partir de la propagation distante.
Id	Obtient un identificateur qui est propre à chaque requête.
IdFormat	Obtient le format pour la Id.
IsAllDataRequested	Obtient ou définit une valeur qui indique si cette activité doit être remplie avec toutes les informations de propagation, ainsi que toutes les autres propriétés telles que les liens, les balises et les événements.
IsStopped	Obtient une valeur qui indique si cet Activity objet est arrêté ou non.
Kind	Obtient la relation entre l’activité, ses parents et ses enfants dans une trace.
Links	Obtient la liste de tous les liens d’activité attachés à cette activité.
OperationName	Obtient le nom de l’opération.
Parent	Obtient le parent de Activity qui a créé cette activité.
ParentId	Obtient l’ID du parent de cette activité.
ParentSpanId	Obtient le SpanId du parent.
Recorded	Obtient une valeur qui indique si l’indicateur W3CIdFlags.Recorded est défini.
RootId	Obtient l’ID racine de ce Activity.
Source	Obtient la source d’activité associée à cette activité.
SpanId	Obtient la partie SPAN du Id.
StartTimeUtc	Obtient l’heure à laquelle l’opération a démarré.
Status	Obtient status code de l’objet d’activité actuel.
StatusDescription	Obtient la description status de l’objet d’activité actuel.
TagObjects	Obtient la liste des balises qui représentent des informations à consigner avec l’activité. Ces informations ne sont pas transmises aux enfants de cette activité.
Tags	Obtient une collection de paires clé-valeur qui représentent les informations à enregistrer avec le Activity dans le système de journalisation.
TraceId	Obtient la partie TraceId du Id.
TraceIdGenerator	Lors du démarrage d’une activité qui n’a pas de contexte parent, l’ID de trace est automatiquement généré à l’aide de nombres aléatoires. TraceIdGenerator peut être utilisé pour remplacer l’algorithme de génération d’ID de trace par défaut du runtime.
TraceStateString	Obtient ou définit l’en-tête tracestate W3C.

Méthodes

AddBaggage(String, String)	Met à jour le Activity pour avoir un nouvel élément bagage avec la clé et la valeur spécifiées.
AddEvent(ActivityEvent)	Ajoute l’événement d’activité spécifié à la liste des événements.
AddTag(String, Object)	Met à jour l’activité pour avoir une balise avec une key et une valuesupplémentaires.
AddTag(String, String)	Met à jour Activity pour avoir une nouvelle balise avec les valeurs key et value fournies.
Dispose()	Arrête l’activité si elle a déjà démarré et avertit tous les écouteurs d’événements. Il ne se passera rien sinon.
Dispose(Boolean)	Si elle est remplacée par un type dérivé, cette méthode libère toutes les ressources allouées.
EnumerateEvents()	Énumère les ActivityEvent objets attachés à cet objet Activity.
EnumerateLinks()	Énumère les ActivityLink objets attachés à cet objet Activity.
EnumerateTagObjects()	Énumère les balises attachées à cet objet Activity.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetBaggageItem(String)	Retourne la valeur d’une paire clé-valeur ajoutée à l’activité avec AddBaggage(String, String).
GetCustomProperty(String)	Retourne l’objet mappé au nom de propriété spécifié.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetTagItem(String)	Retourne la valeur de la balise d’activité mappée à la clé d’entrée. Retourne null si cette clé n’existe pas.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
SetBaggage(String, String)	Ajoutez ou mettez à jour le bagage d’activité avec la clé d’entrée et la valeur. Si la valeur d’entrée est null - si la collection a des bagages avec la même clé, ces bagages seront retirés de la collection. - sinon, rien ne se produira et la collection ne changera pas. Si la valeur d’entrée n’est pas null : si la collection a des bagages avec la même clé, la valeur mappée à cette clé est mise à jour avec la nouvelle valeur d’entrée. - sinon, la clé et la valeur seront ajoutées en tant que nouveau bagage à la collection. Les bagages ne seront mis à jour/supprimés que s’ils ont été ajoutés à l’activité actuelle. Les éléments hérités des parents ne seront pas modifiés/supprimés, le nouvel élément sera ajouté aux bagages d’activité actuels à la place.
SetCustomProperty(String, Object)	Attache n’importe quel objet personnalisé à cette activité. Si le propertyName spécifié a été précédemment associé à un autre objet, la propriété sera mise à jour pour être associée au nouveau propertyValue à la place. Il est recommandé d’utiliser un nom de propriété unique pour éviter les conflits avec toute personne utilisant la même valeur.
SetEndTime(DateTime)	Met à jour le Activity pour définir son Duration comme la différence entre StartTimeUtc et l’heure d’arrêt spécifiée.
SetIdFormat(ActivityIdFormat)	Définit le format d’ID sur ce Activity avant qu’il ne soit démarré.
SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)	Définit l’ID parent à l’aide de la convention W3C d’un TraceId et d’un SpanId.
SetParentId(String)	Met à jour ce Activity pour indiquer que le Activity avec un ID parentId a provoqué ce Activity.
SetStartTime(DateTime)	Définit l’heure de début de ce Activity.
SetStatus(ActivityStatusCode, String)	Définit le code et la description status sur l’objet d’activité actuel.
SetTag(String, Object)	Ajoute ou met à jour la balise d’activité avec la clé d’entrée et la valeur.
Start()	Démarre l’activité.
Stop()	Arrête l’activité.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

CurrentChanged

Se produit quand la valeur Current est modifiée.