WorkflowInstance.TryUnload Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
true
se a instância de fluxo de trabalho foi descarregada, caso contrário, false
.
Exceções
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.