Partage via


Activity Classe

Définition

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

public ref class Activity : IDisposable
public ref class Activity
public class Activity : IDisposable
public class Activity
type Activity = class
    interface IDisposable
type Activity = class
Public Class Activity
Implements IDisposable
Public Class Activity
Héritage
Activity
Implémente

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.

AddException(Exception, TagList, DateTimeOffset)

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

AddLink(ActivityLink)

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

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.

S’applique à