WorkflowInstance.TryUnload Metoda

Definicja

Przestrzeń nazw:

System.Workflow.Runtime

Zestaw:

System.Workflow.Runtime.dll

Zwalnia wystąpienie przepływu pracy z pamięci do magazynu trwałości, gdy wystąpienie jest zawieszone lub bezczynne.

public:
 bool TryUnload();

public bool TryUnload ();

member this.TryUnload : unit -> bool

Public Function TryUnload () As Boolean

Zwraca

Boolean

true jeśli wystąpienie przepływu pracy zostało rozładowane; w przeciwnym razie , false.

Wyjątki

InvalidOperationException

Usługa trwałości nie jest zarejestrowana w aucie środowiska uruchomieniowego przepływu pracy.

Przykłady

W poniższym przykładzie pokazano użycie metody TryUnload w celu zwolnienia przepływu pracy po uruchomieniu WorkflowIdled zdarzenia. Ten przykład pochodzi z przykładowego zestawu SDK Using Persistence Services z pliku Program.cs. Aby uzyskać więcej informacji, zobacz Using Persistence Services Sample (Korzystanie z przykładu usługi Persistence Services).

//Called when the workflow is idle - in this sample this occurs when the workflow is waiting on the
// delay1 activity to expire
static void OnWorkflowIdled(object sender, WorkflowEventArgs e)
{
    Console.WriteLine("Workflow is idle.");
    e.WorkflowInstance.TryUnload();
}

'Called when the workflow is idle - in me sample me occurs when the workflow is waiting on the
' delay1 activity to expire
Shared Sub OnWorkflowIdled(ByVal sender As Object, ByVal e As WorkflowEventArgs)
    Console.WriteLine("Workflow is idle.")
    e.WorkflowInstance.TryUnload()
End Sub

Uwagi

Jeśli wystąpienie przepływu pracy jest bezczynne lub zawieszone, użyje usługi trwałości, TryUnload aby usunąć wystąpienie przepływu pracy z pamięci i utrwało je w magazynie danych. Jeśli usługa trwałości nie jest zarejestrowana w usłudze WorkflowRuntime, TryUnload zgłasza błąd InvalidOperationException. Jeśli wystąpienie przepływu pracy zostało pomyślnie utrwalone, środowisko uruchomieniowe zgłasza WorkflowUnloaded zdarzenie i zwraca wartość true. Unload Zwraca wartość false , jeśli wystąpienie przepływu pracy zostało już rozładowane, zostało zakończone, zostało przerwane lub zostało już ukończone.

Host może używać TryUnload do odzyskiwania zasobów systemowych z bezczynnego przepływu pracy.