WorkflowPersistenceService Classe

Definizione

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

Ereditarietà

Object

WorkflowRuntimeService

WorkflowPersistenceService

Derivato

System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService

Attributi

ObsoleteAttribute

Commenti

Quando si verificano determinate condizioni durante l'esecuzione del flusso di lavoro, il motore di runtime del flusso di lavoro mantiene le informazioni sullo stato relative all'istanza del flusso di lavoro. La persistenza può verificarsi, ad esempio, al termine di una transazione atomica, quando l'istanza del flusso di lavoro diventa inattiva, quando l'host chiama WorkflowInstance.Unload sull'istanza del flusso di lavoro o quando un'istanza del flusso di lavoro viene terminata o terminata. Quando la semantica del motore di runtime del flusso di lavoro determina che deve verificarsi la persistenza, il motore di runtime del flusso di lavoro chiama i metodi forniti da un servizio di persistenza per salvare le informazioni sullo stato relative all'istanza del flusso di lavoro. Analogamente, quando il motore di runtime del flusso di lavoro deve ripristinare un'istanza del flusso di lavoro persistente in precedenza, chiama i metodi forniti dal servizio di persistenza per caricare queste informazioni sullo stato. Il motore di runtime del flusso di lavoro gestisce tutta la semantica relativa all'esecuzione della persistenza. Il servizio di persistenza gestisce effettivamente il salvataggio e il caricamento delle informazioni sullo stato del flusso di lavoro da o verso un archivio dati.

È possibile creare un servizio di persistenza derivando una classe dalla WorkflowPersistenceService classe . È possibile aggiungere il servizio di persistenza al motore di runtime del flusso di lavoro chiamando AddService o effettuando una voce appropriata nel file di configurazione dell'applicazione. Deve WorkflowRuntime contenere un solo servizio di persistenza. Windows Workflow Foundation fornisce la classe SqlWorkflowPersistenceService, un servizio di persistenza risolto, che è possibile usare così come è o estendere.

Il motore di runtime del flusso di lavoro ha una semantica per bloccare le informazioni sullo stato del flusso di lavoro da usare negli ambienti in cui i servizi di persistenza eseguiti in processi diversi potrebbero avere accesso a un singolo archivio dati. La WorkflowPersistenceService classe offre la possibilità di supportare questa funzionalità del motore di runtime del flusso di lavoro fornendo un parametro a SaveWorkflowInstanceState che specifica se le informazioni sullo stato di un'istanza del flusso di lavoro devono essere sbloccate nell'archivio dati e fornendo un metodo UnlockWorkflowInstanceState per sbloccare le informazioni sullo stato del flusso di lavoro bloccate in precedenza. In un servizio di persistenza che implementa il blocco, una chiamata a LoadWorkflowInstanceState deve bloccare le informazioni sullo stato per un'istanza del flusso di lavoro.

Il servizio di persistenza deve generare un'eccezione PersistenceException se non riesce a salvare le informazioni sullo stato nell'archivio dati o caricare le informazioni sullo stato dall'archivio dati. Il motore di runtime del flusso di lavoro prevede questo comportamento.

Viene fornito un meccanismo di invio in batch per i servizi che usano un archivio durevole per salvare le informazioni sullo stato del flusso di lavoro. In questi casi è importante mantenere la coerenza tra l'archivio durevole usato dal servizio di persistenza e lo stato interno del motore di runtime del flusso di lavoro. È possibile aggiungere funzionalità definite dall'interfaccia al servizio e quindi partecipare all'invio in batch delle transazioni del flusso di lavoro fornite da aggiungendo modifiche all'archivio IPendingWorkWorkflowCommitWorkBatchService dati come elementi di lavoro a WorkBatch. L'archivio permanente deve implementare l'interfaccia, in modo che le IEnlistmentNotification informazioni sul flusso di lavoro non vengano mantenute in modo errato in caso di rollback di una transazione. Per altre informazioni, vedere SaveCompletedContextActivity o SaveWorkflowInstanceState.