WorkflowPersistenceService Klas

Definitie

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

Overname

Object

WorkflowRuntimeService

WorkflowPersistenceService

Afgeleid

System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService

Kenmerken

ObsoleteAttribute

Opmerkingen

Wanneer bepaalde voorwaarden optreden terwijl de werkstroom wordt uitgevoerd, blijft de werkstroomruntime-engine statusinformatie over het werkstroomexemplaren behouden. Persistentie kan bijvoorbeeld optreden wanneer een atomische transactie is voltooid, wanneer het werkstroomexemplaren inactief worden, wanneer de host het werkstroomexemplaren aanroept WorkflowInstance.Unload of wanneer een werkstroomexemplaren wordt beëindigd of voltooid. Wanneer de semantiek van de werkstroomruntime-engine dicteert dat persistentie moet plaatsvinden, roept de runtime-engine methoden aan die worden geleverd door een persistentieservice om statusinformatie over het werkstroomexemplaren op te slaan. Wanneer de runtime-engine van de werkstroom een eerder persistent werkstroomexemplaren moet herstellen, worden methoden aangeroepen die worden geleverd door de persistentieservice om deze statusgegevens te laden. De runtime-engine van de werkstroom verwerkt alle semantiek met betrekking tot het uitvoeren van persistentie. De persistentieservice verwerkt het opslaan en laden van de statusgegevens van de werkstroom naar of uit een gegevensarchief.

U kunt een persistentieservice maken door een klasse van de WorkflowPersistenceService klasse af te leiden. U kunt uw persistentieservice toevoegen aan de runtime-engine van de werkstroom door aan te roepen AddService of door een geschikte vermelding te maken in het configuratiebestand van de toepassing. De WorkflowRuntime service mag slechts één persistentieservice bevatten. Windows Workflow Foundation biedt de klasse SqlWorkflowPersistenceService, een out-of-box persistentieservice, die u kunt gebruiken als zodanig of uitbreiden.

De runtime-engine van de werkstroom heeft semantiek voor het vergrendelen van werkstroomstatusgegevens voor gebruik in omgevingen waar persistentieservices die in verschillende processen worden uitgevoerd, mogelijk toegang hebben tot één gegevensarchief. De WorkflowPersistenceService klasse biedt de mogelijkheid om deze functionaliteit van de werkstroomruntime-engine te ondersteunen door een parameter op te SaveWorkflowInstanceState geven die aangeeft of de statusgegevens van een werkstroomexemplaren moeten worden ontgrendeld in het gegevensarchief en door een methode UnlockWorkflowInstanceState op te geven om eerder vergrendelde werkstroomstatusgegevens te ontgrendelen. In een persistentieservice die vergrendeling implementeert, moet een aanroep om de statusinformatie voor een werkstroomexemplaren te LoadWorkflowInstanceState vergrendelen.

Uw persistentieservice moet een PersistenceException fout genereren als de statusgegevens niet kunnen worden opgeslagen in het gegevensarchief of de statusgegevens uit het gegevensarchief worden geladen. Dit gedrag wordt verwacht door de runtime-engine van de werkstroom.

Er wordt een batchmechanisme geboden voor services die een duurzame opslag gebruiken om werkstroomstatusgegevens op te slaan. Het is belangrijk om in deze gevallen consistentie te behouden tussen de duurzame opslag die wordt gebruikt door de persistentieservice en de interne status van de runtime-engine van de werkstroom. U kunt functionaliteit toevoegen die door de IPendingWork interface aan uw service is gedefinieerd en vervolgens deelnemen aan werkstroomtransactiebatches die door de WorkflowCommitWorkBatchService gebruiker worden geleverd door wijzigingen aan uw gegevensarchief toe te voegen als werkitems aan de WorkBatch. Het duurzame archief zelf moet de IEnlistmentNotification interface implementeren, zodat werkstroomgegevens niet onjuist worden bewaard in het geval van een transactieback. Zie of SaveCompletedContextActivityvoor meer informatieSaveWorkflowInstanceState.