Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

TrackingService, classe

Remarque : cette API est maintenant obsolète.

Fournit l'interface de base entre un service de suivi et 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

Le type TrackingService expose les membres suivants.

  NomDescription
Méthode protégéeTrackingServiceEn cas d'implémentation dans une classe dérivée, initialise une nouvelle instance de la classe TrackingService.
Début

  NomDescription
Propriété protégéeRuntimeObtient WorkflowRuntime pour ce service. (Hérité de WorkflowRuntimeService.)
Propriété protégéeStateObtient l'état de WorkflowRuntimeService. (Hérité de WorkflowRuntimeService.)
Début

  NomDescription
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize 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.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode protégéeGetProfile(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.
Méthode protégéeGetProfile(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é.
Méthode protégéeGetTrackingChannelDoit ê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.
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeOnStartedEn 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.)
Méthode protégéeOnStoppedEn 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.)
Méthode protégéeRaiseServicesExceptionNotHandledEventDéclenche l'événement WorkflowRuntime.ServicesExceptionNotHandled. (Hérité de WorkflowRuntimeService.)
Méthode protégéeStartLors d'une substitution dans une classe dérivée, démarre le service et fait passer la propriété State à Starting. (Hérité de WorkflowRuntimeService.)
Méthode protégéeStopLors d'une substitution dans une classe dérivée, arrête le service et fait passer la propriété State à Stopping. (Hérité de WorkflowRuntimeService.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode protégéeTryGetProfileDoit ê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.
Méthode protégéeTryReloadProfileDoit ê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.
Début

RemarqueRemarque

Ce matériel traite des types et des 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

Pris en charge dans : 4, 3.5, 3.0
Obsolète (avertissement du compilateur) dans 4.5.2
Obsolète (avertissement du compilateur) dans 4.5.1
Obsolète (avertissement du compilateur) dans 4.5

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft