WorkflowApplication.Persist Method (TimeSpan)

.NET Framework (current version)
 

Persists a workflow instance to an instance store using the specified time-out interval.

Namespace:   System.Activities
Assembly:  System.Activities (in System.Activities.dll)

public void Persist(
	TimeSpan timeout
)

Parameters

timeout
Type: System.TimeSpan

The interval in which the persist operation must complete before the operation is canceled and a TimeoutException is thrown.

If the workflow instance was previously loaded from persistence, then the same InstanceStore used to load the workflow is used for persistence. If the workflow was created and has not yet been persisted, then an InstanceStore must be configured before calling this method or else an InvalidOperationException is thrown when this method is called.

The following example calls Persist to persist a workflow instance before the workflow is started. This example is from the StartAndUnloadInstance method in the Persisting a Workflow Application sample.

WorkflowApplication application = new WorkflowApplication(activity);

application.InstanceStore = instanceStore;

//returning IdleAction.Unload instructs the WorkflowApplication to persists application state and remove it from memory  
application.PersistableIdle = (e) =>
{
    return PersistableIdleAction.Unload;
};

application.Unloaded = (e) =>
{
    instanceUnloaded.Set();
};


//This call is not required 
//Calling persist here captures the application durably before it has been started
application.Persist();
id = application.Id;
application.Run();

instanceUnloaded.WaitOne();

.NET Framework
Available since 4.0
Return to top
Show: