WorkflowPersistenceService Klasse

Definition

Namespace:

System.Workflow.Runtime.Hosting

Assembly:

System.Workflow.Runtime.dll

Achtung

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

Die abstrakte Basisklasse, von der alle Persistenzdienste abgeleitetet werden.

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

Vererbung

Object

WorkflowRuntimeService

WorkflowPersistenceService

Abgeleitet

System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService

Attribute

ObsoleteAttribute

Hinweise

Hinweis

In diesem Material werden veraltete Typen und Namespaces erläutert. Weitere Informationen finden Sie unter Veraltete Typen in Windows Workflow Foundation 4.5.

Wenn beim Ausführen des Workflows bestimmte Bedingungen eintreten, speichert die Workflowruntime-Engine Zustandsinformationen zur Workflowinstanz. Die Speicherung kann z. B. erfolgen, wenn eine atomarische Transaktion abgeschlossen wird, wenn die Workflowinstanz in den Leerlauf wechselt, wenn der Host WorkflowInstance.Unload für die Workflowinstanz aufruft, oder wenn eine Workflowinstanz beendet wird. Wenn die Semantik der Workflowruntime-Engine eine Speicherung verlangt, ruft die Workflowruntime-Engine von einem Persistenzdienst bereitgestellte Methoden auf, um Zustandsinformationen zur Workflowinstanz zu speichern. Muss dementsprechend die Workflowruntime-Engine eine zuvor gespeicherte Workflowinstanz wiederherstellen, ruft sie von einem Persistenzdienst bereitgestellte Methoden auf, um diese Zustandsinformationen zu laden. Die Workflowruntime-Engine verarbeitet jede Semantik, die sich darauf bezieht, wann eine Speicherung ausgeführt werden soll. Der Persistenzdienst übernimmt das tatsächliche Speichern und Laden der Workflowzustandsinformationen in einen Datenspeicher und aus einem Datenspeicher.

Sie können einen Persistenzdienst erstellen, indem Sie eine Klasse von der WorkflowPersistenceService-Klasse ableiten. Sie können den Persistenzdienst der Workflowruntime-Engine hinzufügen, indem Sie AddService aufrufen oder einen entsprechenden Eintrag in die Anwendungskonfigurationsdatei aufnehmen. WorkflowRuntime sollte nur einen Persistenzdienst enthalten. Von Windows Workflow Foundation wird die SqlWorkflowPersistenceService-Klasse bereitgestellt. Diesen vordefinierten Persistenzdienst können Sie sofort verwenden oder erweitern.

Die Workflowruntime-Engine verfügt über Semantik zum Sperren von Workflowzustandsinformationen. Diese Semantik kann in Umgebungen verwendet werden, in denen in verschiedenen Prozessen ausgeführte Persistenzdienste möglicherweise Zugriff auf einen einzigen Datenspeicher haben. Die WorkflowPersistenceService-Klasse kann diese Funktionalität der Workflowruntime-Engine unterstützen. Dazu wird für SaveWorkflowInstanceState ein Parameter bereitgestellt, der angibt, ob die Zustandsinformationen einer Workflowinstanz im Datenspeicher gesperrt werden sollen. Außerdem wird eine UnlockWorkflowInstanceState-Methode zum Entsperren von gesperrten Workflowzustandsinformationen bereitgestellt. Bei einem Persistenzdienst, von dem das Sperren implementiert wird, sollten durch einen Aufruf von LoadWorkflowInstanceState die Zustandsinformationen für eine Workflowinstanz gesperrt werden.

Der Persistenzdienst sollte PersistenceException auslösen, wenn die Zustandsinformationen nicht im Datenspeicher gespeichert oder aus dem Datenspeicher geladen werden können. Von der Workflowruntime-Engine wird dieses Verhalten vorausgesetzt.

Ein Batchverarbeitungsmechanismus wird für Dienste bereitgestellt, die einen permanenten Speicher zum Speichern von Workflowzustandsinformationen verwenden. In diesen Fällen ist es wichtig, dass der vom Persistenzdienst verwendete permanente Speicher und der interne Zustand der Workflowruntime-Engine konsistent bleiben. Dem Dienst kann Funktionalität hinzugefügt werden, die mit der IPendingWork-Schnittstelle definiert wird. Sie können dann auch die Batchverarbeitung für Workflowtransaktionen verwenden, die von WorkflowCommitWorkBatchService bereitgestellt wird, indem Sie Änderungen am Datenspeicher WorkBatch als Arbeitselement hinzufügen. Der permanente Speicher sollte die IEnlistmentNotification-Schnittstelle implementieren, sodass Workflowinformationen bei einem Transaktionsrollback nicht fälschlicherweise dauerhaft gespeichert werden. Weitere Informationen finden Sie unter SaveCompletedContextActivity oder SaveWorkflowInstanceState.

Konstruktoren

WorkflowPersistenceService()

Veraltet. Initialisiert beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der WorkflowPersistenceService-Klasse.

Eigenschaften

Runtime	Veraltet. Ruft WorkflowRuntime für diesen Dienst ab. (Geerbt von WorkflowRuntimeService)
State	Veraltet. Ruft den Zustand der WorkflowRuntimeService ab. (Geerbt von WorkflowRuntimeService)

Methoden

Equals(Object)	Veraltet. Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetDefaultSerializedForm(Activity)	Veraltet. Ruft das serialisierte Standardformat von Activity ab.
GetHashCode()	Veraltet. Fungiert als Standardhashfunktion. (Geerbt von Object)
GetIsBlocked(Activity)	Veraltet. Gibt an, ob die gegebene Aktivität blockiert wird.
GetSuspendOrTerminateInfo(Activity)	Veraltet. Ruft die Beendigungs- oder Unterbrechungsinformationen der angegebenen Aktivität ab.
GetType()	Veraltet. Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetWorkflowStatus(Activity)	Veraltet. Ruft den Status des Workflows ab.
LoadCompletedContextActivity(Guid, Activity)	Veraltet. Bei Implementierung in einer abgeleiteten Klasse, wird der angegebene abgeschlossene Bereich zurück in den Arbeitsspeicher geladen.
LoadWorkflowInstanceState(Guid)	Veraltet. Bei Implementierung in einer abgeleiteten Klasse, wird der angegebene Zustand der Workflowinstanz wieder in den Arbeitsspeicher geladen.
MemberwiseClone()	Veraltet. Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnStarted()	Veraltet. Stellt beim Überschreiben in einer abgeleiteten Klasse die Methode dar, die aufgerufen wird, wenn die Workflowruntime-Engine das Started-Ereignis auslöst. (Geerbt von WorkflowRuntimeService)
OnStopped()	Veraltet. Stellt beim Überschreiben in einer abgeleiteten Klasse die Methode dar, die aufgerufen wird, wenn die Workflowruntime-Engine das Stopped-Ereignis auslöst. (Geerbt von WorkflowRuntimeService)
RaiseServicesExceptionNotHandledEvent(Exception, Guid)	Veraltet. Löst das ServicesExceptionNotHandled-Ereignis aus. (Geerbt von WorkflowRuntimeService)
RestoreFromDefaultSerializedForm(Byte[], Activity)	Veraltet. Stellt die Activity aus ihrem serialisierten Format wieder her.
SaveCompletedContextActivity(Activity)	Veraltet. Bei Implementierung in einer abgeleiteten Klasse, wird der angegebene abgeschlossene Bereich in einen Datenspeicher geladen.
SaveWorkflowInstanceState(Activity, Boolean)	Veraltet. Bei Implementierung in einer abgeleiteten Klasse, wird der Zustand der Workflowinstanz in einem Datenspeicher gespeichert.
Start()	Veraltet. Startet beim Überschreiben in einer abgeleiteten Klasse den Dienst und ändert State in Starting. (Geerbt von WorkflowRuntimeService)
Stop()	Veraltet. Beendet beim Überschreiben in einer abgeleiteten Klasse den Dienst und ändert State in Stopping. (Geerbt von WorkflowRuntimeService)
ToString()	Veraltet. Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
UnloadOnIdle(Activity)	Veraltet. Bestimmt, ob ein Workflow im Leerlauf entladen werden soll.
UnlockWorkflowInstanceState(Activity)	Veraltet. Entsperrt beim Überschreiben in einer abgeleiteten Klasse den Zustand der Workflowinstanz.