Share via

IDurableOrchestrationContext.ContinueAsNew(Object, Boolean) Method

  • Reference

Definition

Namespace:
Microsoft.Azure.WebJobs.Extensions.DurableTask
Assembly:
Microsoft.Azure.WebJobs.Extensions.DurableTask.dll
Package:
Microsoft.Azure.WebJobs.Extensions.DurableTask v2.8.1
Source:
IDurableOrchestrationContext.cs

Restarts the orchestration by clearing its history.

public void ContinueAsNew (object input, bool preserveUnprocessedEvents = false);
abstract member ContinueAsNew : obj * bool -> unit
Public Sub ContinueAsNew (input As Object, Optional preserveUnprocessedEvents As Boolean = false)

Parameters

input
Object

The JSON-serializeable data to re-initialize the instance with.

preserveUnprocessedEvents
Boolean

If set to true, re-adds any unprocessed external events into the new execution history when the orchestration instance restarts. If false, any unprocessed external events will be discarded when the orchestration instance restarts.

Remarks

Large orchestration histories can consume a lot of memory and cause delays in instance load times. This method can be used to periodically truncate the stored history of an orchestration instance.

Note that any unprocessed external events will be discarded when an orchestration instance restarts itself using this method.

Applies to