WorkflowPersistenceService Classe

Définition

Espace de noms:

System.Workflow.Runtime.Hosting

Assembly:

System.Workflow.Runtime.dll

Attention

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

Classe de base abstraite à partir de laquelle tous les services de persistance sont dérivés.

public ref class WorkflowPersistenceService 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 WorkflowPersistenceService : System.Workflow.Runtime.Hosting.WorkflowRuntimeService

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

Public MustInherit Class WorkflowPersistenceService
Inherits WorkflowRuntimeService

Héritage

Object

WorkflowRuntimeService

WorkflowPersistenceService

Dérivé

System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService

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.

Lorsque certaines conditions se produisent pendant que le workflow s'exécute, le moteur d'exécution de workflow rend persistantes les informations d'état relatives à l'instance de workflow. Par exemple, la persistance peut se produire lorsqu’une transaction atomique se termine, que l’instance de workflow devient inactive, que l’hôte appelle la méthode WorkflowInstance.Unload sur l’instance de workflow ou qu’une instance de workflow est terminée ou se termine. Lorsque la sémantique du moteur d'exécution de workflow détermine que la persistance doit avoir lieu, le moteur d'exécution de workflow appelle les méthodes fournies par un service de persistance pour enregistrer les informations d'état relatives à l'instance de workflow. De même, lorsque le moteur d'exécution de workflow doit restaurer une instance de workflow rendue persistante auparavant, il appelle les méthodes fournies par le service de persistance pour charger ces informations d'état. Le moteur d'exécution de workflow gère toute la sémantique ayant trait au moment de l'exécution de la persistance. Le service de persistance gère l'enregistrement et le chargement des informations d'état du workflow vers ou à partir d'une banque de données.

Vous pouvez créer un service de persistance en dérivant une classe de WorkflowPersistenceService. Vous pouvez ajouter un service de persistance au moteur d'exécution de workflow en appelant la méthode AddService ou en effectuant une entrée appropriée dans le fichier de configuration de l'application. La classe WorkflowRuntime doit contenir un seul service de persistance. Windows Workflow Foundation fournit la classe SqlWorkflowPersistenceService, un service de persistance prédéfini, que vous pouvez utiliser tel quel ou développer.

Le moteur d'exécution de workflow dispose d'une sémantique qui permet de verrouiller les informations d'état du workflow à utiliser dans les environnements où les services de persistance qui s'exécutent dans des processus différents peuvent avoir accès à une banque de données unique. La classe WorkflowPersistenceService fournit la capacité de prise en charge de ces fonctionnalités du moteur d'exécution de workflow en fournissant un paramètre à la méthode SaveWorkflowInstanceState qui spécifie si les informations d'état d'une instance de workflow doivent être déverrouillées dans la banque de données et en fournissant une méthode UnlockWorkflowInstanceState pour déverrouiller les informations d'état du workflow verrouillées précédemment. Dans un service de persistance qui implémente le verrouillage, un appel à la méthode LoadWorkflowInstanceState doit pouvoir verrouiller les informations d'état d'une instance de workflow.

Votre service de persistance doit lever une classe PersistenceException s'il ne peut pas enregistrer les informations d'état dans sa banque de données ni charger les informations d'état depuis sa banque de données. Le moteur d'exécution de workflow prévoit ce comportement.

Un mécanisme de traitement par lots est fourni pour les services qui utilisent un magasin fiable pour enregistrer les informations d'état du workflow. Dans ces situations, il est souvent important de maintenir la cohérence entre le magasin fiable utilisé par le service de persistance et l'état interne du moteur d'exécution de workflow. Vous pouvez ajouter des fonctionnalités définies par l'interface IPendingWork à votre service, puis participer au traitement par lots de la transaction de workflow fournie par la classe WorkflowCommitWorkBatchService en ajoutant des modifications à votre banque de données en tant qu'éléments de travail de la propriété WorkBatch. Le magasin fiable lui-même doit implémenter l’interface IEnlistmentNotification afin que les informations de workflow ne deviennent pas incorrectement persistantes en cas de restauration d’une transaction. Pour plus d'informations, consultez SaveCompletedContextActivity ou SaveWorkflowInstanceState.

Constructeurs

WorkflowPersistenceService()

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

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)
GetDefaultSerializedForm(Activity)	Obsolète. Récupère la forme par défaut sérialisée de la classe Activity.
GetHashCode()	Obsolète. Fait office de fonction de hachage par défaut. (Hérité de Object)
GetIsBlocked(Activity)	Obsolète. Indique si l'activité donnée est bloquée.
GetSuspendOrTerminateInfo(Activity)	Obsolète. Récupère l'arrêt ou interrompt les informations de l'activité donnée.
GetType()	Obsolète. Obtient le Type de l'instance actuelle. (Hérité de Object)
GetWorkflowStatus(Activity)	Obsolète. Récupère l'état du workflow.
LoadCompletedContextActivity(Guid, Activity)	Obsolète. En cas d'implémentation dans une classe dérivée, recharge l'objectif achevé spécifié en mémoire.
LoadWorkflowInstanceState(Guid)	Obsolète. En cas d'implémentation dans une classe dérivée, recharge l'état spécifié de l'instance de workflow en mémoire.
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)
RestoreFromDefaultSerializedForm(Byte[], Activity)	Obsolète. Restaure Activity depuis sa forme sérialisée.
SaveCompletedContextActivity(Activity)	Obsolète. En cas d'implémentation dans une classe dérivée, enregistre l'objectif achevé spécifié dans une banque de données.
SaveWorkflowInstanceState(Activity, Boolean)	Obsolète. En cas d'implémentation dans une classe dérivée, enregistrer l'état de l'instance de workflow dans un magasin de données.
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)
UnloadOnIdle(Activity)	Obsolète. Détermine si un workflow doit être déchargé lorsqu'il est inactif.
UnlockWorkflowInstanceState(Activity)	Obsolète. En cas de substitution dans une classe dérivée, déverrouille l'état de l'instance de workflow.