WorkflowInstance.TryUnload Método

Definición

Espacio de nombres:

System.Workflow.Runtime

Ensamblado:

System.Workflow.Runtime.dll

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

Boolean

true si se descargara la instancia de flujo de trabajo; de lo contrario, false.

Excepciones

InvalidOperationException

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.