WorkflowInstance Klasse

Definition

Achtung

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

Stellt eine Workflowinstanz dar.

public ref class WorkflowInstance sealed
public sealed class WorkflowInstance
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public sealed class WorkflowInstance
type WorkflowInstance = class
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type WorkflowInstance = class
Public NotInheritable Class WorkflowInstance
Vererbung
WorkflowInstance
Attribute

Beispiele

Das folgende Codebeispiel zeigt, wie Sie eine WorkflowInstance in einem Workflowhost erstellen und starten können. Der Code erstellt eine WorkflowRuntime-Instanz, fügt der Laufzeit Dienste hinzu und zeigt dann die empfohlene Vorgehensweise zum Erstellen eines WorkflowInstance-Objekts. Im Code wird die WorkflowInstance initialisiert, indem er die CreateWorkflow-Methode aufruft und den vorher erstellten Typ an sie übergibt. Die WorkflowInstance wird mit dem Start-Methodenaufruf gestartet.

Dieses Codebeispiel ist Teil des Canceling a Workflow SDK-Beispiels in der Datei Program.cs. Weitere Informationen finden Sie unter Abbrechen eines Workflows.

Type type = typeof(SampleWorkflow1);
WorkflowInstance workflowInstance = workflowRuntime.CreateWorkflow(type);
workflowInstance.Start();
Dim workflowInstance As WorkflowInstance
workflowInstance = workflowRuntime.CreateWorkflow(GetType(SampleWorkflow))
workflowInstance.Start()

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.

Die WorkflowInstance-Klasse macht Methoden und Eigenschaften verfügbar, die verwendet werden können, um die Ausführung einer Workflowinstanz zu steuern. Es handelt sich dabei im Wesentlichen um einen Proxy der eigentlichen Workflowinstanz, die von der Workflowruntime-Engine verwendet wird. Ein Host oder ein Dienst kann die Workflowruntime-Engine anweisen, Aktionen für eine Workflowinstanz durchzuführen, indem er die entsprechenden Methoden aufruft, die in der WorkflowInstance-Klasse enthalten sind. Wenn die angeforderte Aktion nicht gültig ist, z.B. wenn der Host Load für eine Workflowinstanz aufruft, die bereits abgeschlossen wurde, löst die Workflowruntime-Engine eine entsprechende Ausnahme aus.

Hinweis

Wenn eine Workflowinstanz nicht mehr reagiert, weil für einen Aufruf der Hostanwendung keine Rückgabe erfolgt, kann die Instanz nur durch das Neustarten der Laufzeit wiederhergestellt werden. Wenn die Instanz jedoch zwangsweise entladen, abgebrochen oder unterbrochen wurde, können Sie sie fortsetzen, indem Sie die WorkflowInstance.Resume-Methode aufrufen.

Eigenschaften

InstanceId
Veraltet.

Ruft den eindeutigen Bezeichner der Workflowinstanz ab.

WorkflowRuntime
Veraltet.

Ruft WorkflowRuntime für diese Workflowinstanz ab.

Methoden

Abort()
Veraltet.

Bricht die Workflowinstanz ab.

ApplyWorkflowChanges(WorkflowChanges)
Veraltet.

Übernimmt Änderungen für die vom WorkflowChanges-Objekt angegebene Workflowinstanz.

EnqueueItem(IComparable, Object, IPendingWork, Object)
Veraltet.

Sendet synchron eine Meldung an die angegebene Workflowwarteschlange.

EnqueueItemOnIdle(IComparable, Object, IPendingWork, Object)
Veraltet.

Sendet eine Meldung an die angegebene Workflowwarteschlange, wenn sich der Workflow im Leerlauf befindet. EnqueueItemOnIdle(IComparable, Object, IPendingWork, Object) wartet, bis der Workflow einen Leerlaufpunkt erreicht, und wird eingereiht, nachdem sichergestellt ist, dass sich der Workflowplaner im Leerlauf befindet (also wenn kein aktiver Vorgang ausgeführt wird).

Equals(Object)
Veraltet.

Gibt einen Wert zurück, der angibt, ob das angegebene Objekt der WorkflowInstance entspricht.

GetHashCode()
Veraltet.

Gibt den Hashcode für diese Workflowinstanz zurück.

GetType()
Veraltet.

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetWorkflowDefinition()
Veraltet.

Ruft die Stammaktivität für diese Workflowinstanz ab.

GetWorkflowNextTimerExpiration()
Veraltet.

Gibt den nächsten Zeitpunkt zurück, für den geplant ist, dass diese WorkflowInstance eine Zeitgebermeldung erhält.

GetWorkflowQueueData()
Veraltet.

Ruft eine Auflistung von WorkflowQueueInfo-Objekten ab, die die anstehenden Elemente und abonnierten Aktivitäten für die Workflowwarteschlangen enthält, die dieser Workflowinstanz zugeordnet sind.

Load()
Veraltet.

Lädt eine vorher entladene Workflowinstanz.

MemberwiseClone()
Veraltet.

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ReloadTrackingProfiles()
Veraltet.

Laden Sie die Verfolgungsprofile für diese Workflowinstanz neu.

Resume()
Veraltet.

Setzt die Ausführung einer vorher unterbrochenen Workflowinstanz fort.

Start()
Veraltet.

Startet die Ausführung der Workflowinstanz.

Suspend(String)
Veraltet.

Unterbricht die Workflowinstanz.

Terminate(String)
Veraltet.

Beendet die Workflowinstanz auf synchrone Weise.

ToString()
Veraltet.

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TryUnload()
Veraltet.

Entlädt die Workflowinstanz aus dem Arbeitsspeicher in den Persistenzspeicher, wenn die Instanz unterbrochen wird oder sich im Leerlauf befindet.

Unload()
Veraltet.

Entlädt die Workflowinstanz aus dem Arbeitsspeicher in den Persistenzspeicher. Dieser Aufruf wird so lange blockiert, bis die derzeit geplante Arbeit beendet bzw. das Ende des Transaktionsumfangs erreicht ist.

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen