WorkflowPersistenceService Classe

Définition

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

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.*")]
public abstract class WorkflowPersistenceService : System.Workflow.Runtime.Hosting.WorkflowRuntimeService

type WorkflowPersistenceService = class
    inherit 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

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

Propriétés

Méthodes

S’applique à