WorkflowInstance.TryUnload Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Descarga la instancia de flujo de trabajo de la memoria al almacén de persistencia cuando la instancia se suspende o está inactiva.
public:
bool TryUnload();
public bool TryUnload ();
member this.TryUnload : unit -> bool
Public Function TryUnload () As Boolean
Devoluciones
true
si se descargara la instancia de flujo de trabajo; de lo contrario, false
.
Excepciones
No hay ningún servicio de persistencia registrado con el motor en tiempo de ejecución de flujo de trabajo.
Ejemplos
El ejemplo siguiente muestra cómo utilizar el método TryUnload para descargar un flujo de trabajo cuando se desencadena el evento WorkflowIdled. Este ejemplo pertenece a la muestra de SDK de Utilizar Servicios de Persistencia, del archivo Program.cs. Para obtener más información, vea Uso del ejemplo de Servicios de persistencia.
//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
Comentarios
Si la instancia de flujo de trabajo está inactiva o suspendida, TryUnload utiliza el servicio de persistencia para quitar la instancia de flujo de trabajo de la memoria y conservarla en un almacén de datos. Si no hay ningún servicio de persistencia registrado con WorkflowRuntime, TryUnload inicia InvalidOperationException. Si la instancia de flujo de trabajo se conserva correctamente, el tiempo de ejecución genera el WorkflowUnloaded evento y devuelve true
.
Unload devuelve false
si la instancia de flujo de trabajo ya se ha descargado, se ha terminado, se ha anulado o ya se ha completado.
El host puede utilizar TryUnload para reclamar los recursos del sistema de un flujo de trabajo inactivo.