Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

TrackingService classe

 

Date de publication : novembre 2016

Remarque : Cette API est désormais obsolète.

Fournit l’interface de base entre un service de suivi et de l’infrastructure de suivi d’exécution.

Espace de noms:   System.Workflow.Runtime.Tracking
Assembly:  System.Workflow.Runtime (dans System.Workflow.Runtime.dll)


[ObsoleteAttribute("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public abstract class TrackingService : WorkflowRuntimeService

NomDescription
System_CAPS_protmethodTrackingService()

Lors de l'implémentation dans une classe dérivée, initialise une nouvelle instance de la classe TrackingService.

NomDescription
System_CAPS_protpropertyRuntime

Obtient WorkflowRuntime pour ce service.(Hérité de WorkflowRuntimeService.)

System_CAPS_protpropertyState

Obtient l'état de WorkflowRuntimeService.(Hérité de WorkflowRuntimeService.)

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_protmethodGetProfile(Guid)

Doit être substitué dans la classe dérivée et, en cas d'implémentation, retourne le modèle de suivi pour l'instance de workflow spécifiée.

System_CAPS_protmethodGetProfile(Type, Version)

Doit être substitué dans la classe dérivée et, en cas d'implémentation, retourne le modèle de suivi, qualifié par version, pour le Type de workflow spécifié.

System_CAPS_protmethodGetTrackingChannel(TrackingParameters)

Doit être substitué dans la classe dérivée et, en cas d'implémentation, retourne le canal que l'infrastructure de suivi d'exécution utilise pour envoyer des enregistrements de suivi au service de suivi.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnStarted()

En cas de substitution dans une classe dérivée, représente la méthode qui est appelée lorsque le moteur d'exécution de workflow déclenche l'événement WorkflowRuntime.Started.(Hérité de WorkflowRuntimeService.)

System_CAPS_protmethodOnStopped()

En cas de substitution dans une classe dérivée, représente la méthode qui est appelée lorsque le moteur d'exécution de workflow déclenche l'événement WorkflowRuntime.Stopped.(Hérité de WorkflowRuntimeService.)

System_CAPS_protmethodRaiseServicesExceptionNotHandledEvent(Exception, Guid)
System_CAPS_protmethodStart()

En cas de substitution dans une classe dérivée, démarre le service et fait passer la propriété State à Starting.(Hérité de WorkflowRuntimeService.)

System_CAPS_protmethodStop()

En cas de substitution dans une classe dérivée, arrête le service et fait passer la propriété State à Stopping.(Hérité de WorkflowRuntimeService.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodTryGetProfile(Type, TrackingProfile)

Doit être substitué dans la classe dérivée et, en cas d'implémentation, récupère le modèle de suivi pour le type de workflow spécifié s'il y en a un disponible.

System_CAPS_protmethodTryReloadProfile(Type, Guid, TrackingProfile)

Doit être substitué dans la classe dérivée et, en cas d'implémentation, récupère un nouveau modèle de suivi pour l'instance de workflow spécifiée si le modèle de suivi a changé depuis son dernier chargement.

System_CAPS_noteRemarque

Ce document décrit les types et les espaces de noms qui sont obsolètes. Pour plus d’informations, consultez Types déconseillés dans Windows Workflow Foundation 4.5.

Un service de suivi est chargé de fournir des canaux de suivi et des profils de suivi au moteur d'exécution de workflow. Le moteur d'exécution de workflow demande un TrackingChannel à un service de suivi pour chaque instance de workflow pour laquelle il a un TrackingProfile. Le moteur d'exécution de workflow utilise ce TrackingChannel pour envoyer les enregistrements de suivi associés à cette instance de workflow. Un TrackingProfile contient des trackpoints qui spécifient un ensemble d'événements de suivi pour lesquels l'infrastructure de suivi d'exécution doit envoyer des enregistrements de suivi. Un TrackingProfile peut spécifier également les données à extraire de l'instance de workflow lorsque l'un de ces événements de suivi se produit.

L'infrastructure de suivi d'exécution utilise un TrackingProfile pour filtrer les événements de suivi émis par une instance de workflow. Lorsqu'un événement de suivi émis correspondant à un trackpoint dans le TrackingProfile, l'infrastructure de suivi d'exécution extrait toutes les données spécifiées dans le TrackingProfile à partir de l'instance de workflow et encapsule ces données et informations relatives à l'événement de suivi dans un enregistrement de suivi. Cet enregistrement de suivi est ensuite envoyé sur le TrackingChannel associé à l'instance de workflow. Un enregistrement de suivi peut être l'un des types suivants :

ActivityTrackingRecord

UserTrackingRecord

WorkflowTrackingRecord

L'application hôte peut utiliser l'enregistrement de suivi de n'importe quelle façon. Par exemple, elle peut stocker les informations de suivi dans une base de données et les utiliser pour implémenter une interface utilisateur sophistiquée, ou elle peut utiliser les informations pour informer un administrateur d'une condition qui requiert une action. Vous pouvez inscrire un service de suivi auprès du moteur d'exécution de workflow en appelant WorkflowRuntime.AddService ou en incluant l'entrée appropriée dans le fichier de configuration de l'application.

Tous les services de suivi doivent hériter de la classe abstraite TrackingService. Cette classe définit l'interface de base entre un service de suivi et l'infrastructure de suivi d'exécution. Le moteur d'exécution de workflow demande un TrackingProfile pour une instance de workflow ou un Type de workflow spécifique en appelant une des méthodes GetProfile surchargées ou la méthode TryGetProfile. Le moteur d'exécution de workflow appelle GetTrackingChannel pour demander un TrackingChannel.

Le runtime de suivi de workflow appelle les méthodes GetProfile et TryGetProfile chaque fois qu'une instance de workflow est créée ou chargée à partir du magasin de persistance. La surcharge associée à ces appels peut être coûteuse pour le service de suivi (de nombreux appels de base de données, par exemple). Vous pouvez implémenter l'interface IProfileNotification dans votre service de suivi pour contourner ce mécanisme basé sur les appels et utiliser des événements pour informer le moteur d'exécution de workflow des modifications apportées à un TrackingProfile. Pour les services de suivi qui implémentent l'interface IProfileNotification, le moteur d'exécution de workflow s'abonne aux événements ProfileUpdated et ProfileRemoved. Votre service de suivi peut déclencher l'événement approprié lorsqu'une modification de l'un de ses profils de suivi se produit. La classe SqlTrackingService implémente cette interface.

Le moteur d'exécution de workflow appelle la méthode TryReloadProfile pour tester si un TrackingProfile a été mis à jour ou supprimé suite à un appel explicite par un hôte ou un service à ReloadTrackingProfiles sur une instance de workflow. Ce processus permet à un hôte ou un service de modifier dynamiquement le modèle de suivi utilisé pour une instance de workflow spécifique.

Remarques à l’attention des héritiers :

.NET Framework
Disponible depuis 3.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: