WorkflowRuntime.WorkflowUnloaded Ereignis

Definition

Namespace:

System.Workflow.Runtime

Assembly:

System.Workflow.Runtime.dll

Tritt ein, wenn die Workflowinstanz aus dem Arbeitsspeicher entladen wird.

public:
 event EventHandler<System::Workflow::Runtime::WorkflowEventArgs ^> ^ WorkflowUnloaded;

public event EventHandler<System.Workflow.Runtime.WorkflowEventArgs> WorkflowUnloaded;

member this.WorkflowUnloaded : EventHandler<System.Workflow.Runtime.WorkflowEventArgs> 

Public Event WorkflowUnloaded As EventHandler(Of WorkflowEventArgs) 

Ereignistyp

EventHandler<WorkflowEventArgs>

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die WorkflowRuntime-Funktionalität eines Workflowhosts verwenden können. Der Code ordnet WorkflowUnloaded einem Ereignishandler zu. Hierbei handelt es sich um eine Methode mit dem Namen OnWorkflowUnload.

Dieses Codebeispiel ist Teil des Beispiels für den benutzerdefinierten Persistenzdienst.

static void Main()
{
    using (WorkflowRuntime workflowRuntime = new WorkflowRuntime())
    {
        try
        {
            // engine will unload workflow instance when it is idle
            workflowRuntime.AddService(new FilePersistenceService(true));

            workflowRuntime.WorkflowCreated += OnWorkflowCreated;
            workflowRuntime.WorkflowCompleted += OnWorkflowCompleted;
            workflowRuntime.WorkflowIdled += OnWorkflowIdle;
            workflowRuntime.WorkflowUnloaded += OnWorkflowUnload;
            workflowRuntime.WorkflowLoaded += OnWorkflowLoad;
            workflowRuntime.WorkflowTerminated += OnWorkflowTerminated;
            workflowRuntime.ServicesExceptionNotHandled += OnExceptionNotHandled;

            workflowRuntime.CreateWorkflow(typeof(PersistenceServiceWorkflow)).Start();

            waitHandle.WaitOne();
        }
        catch (Exception e)
        {
            Console.WriteLine("Exception \n\t Source: {0} \n\t Message: {1}", e.Source, e.Message);
        }
        finally
        {
            workflowRuntime.StopRuntime();
            Console.WriteLine("Workflow runtime stopped, program exiting... \n");
        }
    }
}

Shared Sub Main()

    Using currentWorkflowRuntime As New WorkflowRuntime()
        Try

            ' engine will unload workflow instance when it is idle
            currentWorkflowRuntime.AddService(New FilePersistenceService(True))

            AddHandler currentWorkflowRuntime.WorkflowCreated, AddressOf OnWorkflowCreated
            AddHandler currentWorkflowRuntime.WorkflowCompleted, AddressOf OnWorkflowCompleted
            AddHandler currentWorkflowRuntime.WorkflowIdled, AddressOf OnWorkflowIdled
            AddHandler currentWorkflowRuntime.WorkflowUnloaded, AddressOf OnWorkflowUnloaded
            AddHandler currentWorkflowRuntime.WorkflowLoaded, AddressOf OnWorkflowLoaded
            AddHandler currentWorkflowRuntime.WorkflowTerminated, AddressOf OnWorkflowTerminated
            AddHandler currentWorkflowRuntime.ServicesExceptionNotHandled, AddressOf OnExceptionNotHandled

            currentWorkflowRuntime.CreateWorkflow(GetType(PersistenceServiceWorkflow)).Start()

            waitHandle.WaitOne()

        Catch e As Exception
            Console.WriteLine("Exception \n\t Source: 0} \n\t Message: 1}", e.Source, e.Message)
        Finally
            currentWorkflowRuntime.StopRuntime()
            Console.WriteLine("Workflow runtime stopped, program exiting... \n")
        End Try
    End Using
End Sub

Hinweise

Eine Workflowinstanz kann aus dem Arbeitsspeicher entladen werden, indem ein expliziter Aufruf von Unload erfolgt, oder sie kann implizit entladen werden, indem die eigene Semantik der Workflowruntime-Engine verwendet wird. Beispielsweise entlädt die Workflowlaufzeit-Engine einen Workflow instance, wenn die instance in den Leerlauf wechselt und die Laufzeit eine WorkflowPersistenceService hinzugefügt hat, für die UnloadOnIdle isttrue.

Die Workflowlaufzeit-Engine löst das WorkflowUnloaded Ereignis aus, nachdem der Status des Workflows instance erfolgreich beibehalten wurde, aber bevor die instance im Arbeitsspeicher ungültig wird. Deshalb geht ein WorkflowPersisted-Ereignis dem WorkflowUnloaded-Ereignis voraus.

Bei dem WorkflowUnloaded-Ereignis enthält der Absender die WorkflowRuntime, und WorkflowEventArgs enthält die WorkflowInstance, die dem Ereignis zugeordnet ist.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.