TrackingService Classe

Définition

Espace de noms:

System.Workflow.Runtime.Tracking

Assembly:

System.Workflow.Runtime.dll

Attention

The System.Workflow.* types are deprecated. Instead, please use the new types from System.Activities.*

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

public ref class TrackingService abstract : System::Workflow::Runtime::Hosting::WorkflowRuntimeService

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

[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type TrackingService = class
    inherit WorkflowRuntimeService

Public MustInherit Class TrackingService
Inherits WorkflowRuntimeService

Héritage

Object

WorkflowRuntimeService

TrackingService

Dérivé

System.Workflow.Runtime.Tracking.SqlTrackingService

Attributs

ObsoleteAttribute

Remarques

Notes

Ce document décrit les types et les espaces de noms qui sont obsolètes. Pour plus d’informations, consultez Types déprécié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.

Notes pour les responsables de l’implémentation

• Lorsque vous héritez de TrackingService, vous devez remplacer les membres suivants : GetProfile(Guid)

• GetProfile(Type, Version)

• TryGetProfile(Type, TrackingProfile)

• GetTrackingChannel(TrackingParameters)

• TryReloadProfile(Type, Guid, TrackingProfile)

Constructeurs

TrackingService()

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

Propriétés

Runtime	Obsolète. Obtient WorkflowRuntime pour ce service. (Hérité de WorkflowRuntimeService)
State	Obsolète. Obtient l'état de WorkflowRuntimeService. (Hérité de WorkflowRuntimeService)

Méthodes

Equals(Object)	Obsolète. Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Obsolète. Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProfile(Guid)	Obsolète. 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.
GetProfile(Type, Version)	Obsolète. 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é.
GetTrackingChannel(TrackingParameters)	Obsolète. 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.
GetType()	Obsolète. Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Obsolète. Crée une copie superficielle du Object actuel. (Hérité de Object)
OnStarted()	Obsolète. 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 Started. (Hérité de WorkflowRuntimeService)
OnStopped()	Obsolète. 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 Stopped. (Hérité de WorkflowRuntimeService)
RaiseServicesExceptionNotHandledEvent(Exception, Guid)	Obsolète. Déclenche l’événement ServicesExceptionNotHandled. (Hérité de WorkflowRuntimeService)
Start()	Obsolète. 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)
Stop()	Obsolète. 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)
ToString()	Obsolète. Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TryGetProfile(Type, TrackingProfile)	Obsolète. 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.
TryReloadProfile(Type, Guid, TrackingProfile)	Obsolète. 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.

Voir aussi

• IProfileNotification