WorkflowInstance.TryUnload Metodo

Definizione

Spazio dei nomi:

System.Workflow.Runtime

Assembly:

System.Workflow.Runtime.dll

Scarica l'istanza del flusso di lavoro dalla memoria all'archivio di persistenza quando l'istanza viene sospesa o è inattiva.

public:
 bool TryUnload();

public bool TryUnload ();

member this.TryUnload : unit -> bool

Public Function TryUnload () As Boolean

Restituisce

Boolean

true se l'istanza del flusso di lavoro è stata scaricata; in caso contrario, false.

Eccezioni

InvalidOperationException

Nessun servizio di persistenza è registrato nel motore di runtime del flusso di lavoro.

Esempio

Nell'esempio seguente è dimostrato l'utilizzo del metodo TryUnload per scaricare un flusso di lavoro quando l'evento WorkflowIdled viene generato. Questo esempio è tratto dall'esempio SDK Using Persistence Services nel file Program.cs. Per altre informazioni, vedere Uso dell'esempio di Servizi di persistenza.

//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

Commenti

Se l'istanza del flusso di lavoro è inattiva o sospesa, TryUnload utilizza il servizio di persistenza per rimuovere l'istanza del flusso di lavoro dalla memoria e renderla persistente in un archivio dati. Se nessun servizio di persistenza è registrato con WorkflowRuntime, TryUnload genera un'eccezione InvalidOperationException. Se l'istanza del flusso di lavoro è stata resa persistente, il runtime genera l'evento WorkflowUnloaded e restituisce true. Unload restituisce false se l'istanza del flusso di lavoro è già stata scaricata, è stata terminata, è stata interrotta o è già stata completata.

L'host può utilizzare il metodo TryUnload per recuperare risorse di sistema da un flusso di lavoro inattivo.