WorkflowPersistenceService Klasse

Definition

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

Vererbung

Object

WorkflowRuntimeService

WorkflowPersistenceService

Abgeleitet

System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService

Attribute

ObsoleteAttribute

Hinweise

Wenn bestimmte Bedingungen auftreten, während der Workflow ausgeführt wird, speichert das Workflowlaufzeitmodul Statusinformationen zur Workflowinstanz. Persistenz kann z. B. auftreten, wenn eine Atomtransaktion abgeschlossen ist, wenn die Workflowinstanz im Leerlauf ist, wenn der Host aufruft WorkflowInstance.Unload , oder wenn eine Workflowinstanz beendet oder beendet wird. Wenn die Semantik des Workflowlaufzeitmoduls bestimmt, dass Persistenz auftreten soll, ruft das Workflowlaufzeitmodul Methoden auf, die von einem Persistenzdienst bereitgestellt werden, um Zustandsinformationen zur Workflowinstanz zu speichern. Ebenso ruft das Workflowlaufzeitmodul, wenn eine zuvor beibehaltene Workflowinstanz wiederhergestellt werden muss, Methoden auf, die vom Persistenzdienst bereitgestellt werden, um diese Statusinformationen zu laden. Das Workflowlaufzeitmodul behandelt alle Semantik, die sich darauf bezieht, wann die Persistenz ausgeführt werden soll. Der Persistenzdienst verarbeitet tatsächlich das Speichern und Laden der Workflowstatusinformationen in oder aus einem Datenspeicher.

Sie können einen Persistenzdienst erstellen, indem Sie eine Klasse von der WorkflowPersistenceService Klasse ableiten. Sie können Ihren Persistenzdienst zum Workflowlaufzeitmodul hinzufügen, indem Sie einen entsprechenden Eintrag in der Anwendungskonfigurationsdatei aufrufen AddService oder einen entsprechenden Eintrag vornehmen. Dies WorkflowRuntime sollte nur einen Persistenzdienst enthalten. Windows Workflow Foundation stellt die klasse SqlWorkflowPersistenceService, einen sofort einsatzbereiten Persistenzdienst bereit, den Sie wie dargestellt oder erweitern können.

Das Workflowlaufzeitmodul verfügt über Semantik zum Sperren von Workflowstatusinformationen für die Verwendung in Umgebungen, in denen Persistenzdienste, die in verschiedenen Prozessen ausgeführt werden, möglicherweise Zugriff auf einen einzelnen Datenspeicher haben. Die WorkflowPersistenceService Klasse bietet die Möglichkeit, diese Funktionalität des Workflowlaufzeitmoduls zu unterstützen, indem ein Parameter SaveWorkflowInstanceState bereitgestellt wird, der angibt, ob die Statusinformationen einer Workflowinstanz im Datenspeicher entsperrt werden sollen, und indem eine Methode UnlockWorkflowInstanceState zum Entsperren zuvor gesperrter Workflowstatusinformationen bereitgestellt wird. In einem Persistenzdienst, der die Sperrung implementiert, sollte ein Aufruf LoadWorkflowInstanceState die Statusinformationen für eine Workflowinstanz sperren.

Ihr Persistenzdienst sollte einen PersistenceException Auslösen auslösen, wenn Statusinformationen nicht im Datenspeicher gespeichert oder Zustandsinformationen aus dem Datenspeicher geladen werden. Das Workflowlaufzeitmodul erwartet dieses Verhalten.

Ein Batchverarbeitungsmechanismus wird für Dienste bereitgestellt, die einen dauerhaften Speicher verwenden, um Workflowstatusinformationen zu speichern. In diesen Fällen ist es wichtig, die Konsistenz zwischen dem dauerhaften Speicher aufrechtzuerhalten, der vom Persistenzdienst und dem internen Zustand des Workflowlaufzeitmoduls verwendet wird. Sie können Dem Dienst definierte Funktionen hinzufügen und dann an der IPendingWork Workflowtransaktionsbatchierung teilnehmen, die WorkflowCommitWorkBatchService durch Hinzufügen von Änderungen an Ihrem Datenspeicher als Arbeitsaufgaben zur WorkBatchVerfügung gestellt wird. Der dauerhafte Speicher selbst sollte die IEnlistmentNotification Schnittstelle implementieren, sodass Workflowinformationen im Falle eines Transaktionsrollbacks nicht falsch beibehalten werden. Weitere Informationen finden Sie unter SaveCompletedContextActivity oder SaveWorkflowInstanceState.