WorkflowInstance.TryUnload Método

Definição

Namespace:

System.Workflow.Runtime

Assembly:

System.Workflow.Runtime.dll

Descarrega a instância de fluxo de trabalho da memória para o repositório de persistência quando a instância está suspensa ou ociosa.

public:
 bool TryUnload();

public bool TryUnload ();

member this.TryUnload : unit -> bool

Public Function TryUnload () As Boolean

Retornos

Boolean

true se a instância de fluxo de trabalho foi descarregada, caso contrário, false.

Exceções

InvalidOperationException

Não há nenhum serviço de persistência registrado no mecanismo de runtime de fluxo de trabalho.

Exemplos

O exemplo a seguir demonstra como usar o método TryUnload para descarregar um fluxo de trabalho quando o evento é acionado WorkflowIdled . Este exemplo é do exemplo Usando o SDK dos Serviços de Persistência, do arquivo Program.cs. Para obter mais informações, consulte Usando o exemplo de serviços de persistência.

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

Comentários

Se a instância de fluxo de trabalho estiver ociosa ou suspensa, TryUnload usará o serviço de persistência para remover a instância de fluxo de trabalho da memória e mantê-la em um armazenamento de dados. Se não houver nenhum serviço de persistência registrado com o WorkflowRuntime, TryUnload gerará um InvalidOperationException. Se a instância de fluxo de trabalho for mantida com êxito, o runtime aciona o WorkflowUnloaded evento e retorna true. Unload retornará false se a instância de fluxo de trabalho já tiver sido descarregada, tiver sido encerrada, tiver sido anulada ou já tiver sido concluída.

O host pode usar TryUnload para recuperar recursos do sistema de um fluxo de trabalho ocioso.