WorkflowInstance.TryUnload Méthode

Définition

Espace de noms:

System.Workflow.Runtime

Assembly:

System.Workflow.Runtime.dll

Décharge l'instance de workflow de la mémoire dans le magasin de persistances lorsque l'instance est interrompue ou inactive.

public:
 bool TryUnload();

public bool TryUnload ();

member this.TryUnload : unit -> bool

Public Function TryUnload () As Boolean

Retours

Boolean

true si l'instance de workflow a été déchargée ; sinon, false.

Exceptions

InvalidOperationException

Aucun service de persistance n'est enregistré auprès du moteur d'exécution de workflow.

Exemples

L'exemple suivant présente l'utilisation de la méthode TryUnload pour décharger un workflow lorsque l'événement WorkflowIdled se déclenche. Cet exemple est issu de l'exemple du Kit de développement logiciel Using Persistence Services (SDK) et provient du fichier Program.cs. Pour plus d’informations, consultez Utilisation de l’exemple 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

Remarques

Si l'instance de workflow est inactive ou suspendue, TryUnload utilise le service de persistance pour supprimer l'instance de workflow de la mémoire et la rendre persistante dans un magasin de données. Si aucun service de persistance n'est enregistré avec le WorkflowRuntime, TryUnload lève une InvalidOperationException. Si le flux de travail instance est correctement conservé, le runtime déclenche l’événement WorkflowUnloaded et retourne true. Unloadretourne false si le flux de travail instance a déjà été déchargé, a été arrêté, a été abandonné ou est déjà terminé.

L'hôte peut utiliser TryUnload pour libérer les ressources système d'un workflow inactif.