Delay(TimeSpan)
static
public static DurableTask Delay(TimeSpan duration)Creates a durable delay measured using host logical time.
Parameters
durationTimeSpan
public static DurableTask Delay(TimeSpan duration)durationTimeSpanpublic static DurableTask DelayUntil(DateTimeOffset dueTime)dueTime, measured using host logical time.dueTimeDateTimeOffsetpublic static DurableTask<TResult> FromResult<TResult>(TResult value)valueTResultpublic static int GetVersion(string name, int minSupported, int maxSupported)name which the running durable task follows, so code which changes a workflow keeps replaying the executions which started before the change. namestring"carrier-api". Every call with the same name in one execution returns the same version. Names don't contain $. minSupportedint0 is the code before the change's first version. maxSupportedintminSupported to maxSupported.System.ArgumentNullExceptionname is null.System.ArgumentExceptionname is empty or contains $.System.ArgumentOutOfRangeExceptionminSupported is negative, or maxSupported is less than minSupported. Orleans.Durable.Tasks.DurableTaskAttemptCanceledExceptionDurableTaskVersionException. System.InvalidOperationExceptionConfigureAwait(false). System.NotSupportedException var version = DurableTask.GetVersion("carrier-api", minSupported: 0, maxSupported: 1); if (version >= 1) { await carrier.BookAsync(order).WithId("book"); } else { await legacyShipping.ShipAsync(order).WithId("ship"); }public static DurableTask<(int Index, TResult Result)> DurableTask.Race<TResult>(IEnumerable<DurableTask<TResult>> tasks)tasksIEnumerable<DurableTask<TResult>>System.ArgumentOutOfRangeExceptiontasks is empty.public static DurableTask<(int Index, TResult Result)> DurableTask.Race<TResult>(IReadOnlyList<DurableTask<TResult>> tasks)tasksIReadOnlyList<DurableTask<TResult>>System.ArgumentOutOfRangeExceptiontasks is empty.public static DurableTask<int> Race(IEnumerable<DurableTask> tasks)tasksIEnumerable<DurableTask>System.ArgumentOutOfRangeExceptiontasks is empty.public static DurableTask<int> Race(IReadOnlyList<DurableTask> tasks)tasksIReadOnlyList<DurableTask>System.ArgumentOutOfRangeExceptiontasks is empty.public static DurableTask Run(Action<CancellationToken> action)action as a child execution when it is awaited, scheduled, or posted.actionAction<CancellationToken>[System.Obsolete(DurableTask.Run runs a delegate as a durable child, and a durable task already runs as one. Await the durable task directly., True)]public static DurableTask Run(Func<CancellationToken, DurableTask> function)functionFunc<CancellationToken, DurableTask>public static DurableTask Run(Func<CancellationToken, Task> function)function as a child execution when it is awaited, scheduled, or posted.functionFunc<CancellationToken, Task>[System.Obsolete(DurableTask.Run runs a delegate as a durable child, and a durable task already runs as one. Await the durable task directly., True)]public static DurableTask Run(Func<DurableTask> function)functionFunc<DurableTask>public static DurableTask Run(Func<Task> function)function as a child execution when it is awaited, scheduled, or posted.functionFunc<Task>System.ArgumentNullExceptionfunction is null.public static DurableTask Run(Func<ValueTask> function)function as a child execution when it is awaited, scheduled, or posted.functionFunc<ValueTask>System.ArgumentNullExceptionfunction is null.public static DurableTask Run<TState>(Action<TState, CancellationToken> action, TState state)action with captured state.actionAction<TState, CancellationToken>stateTStatepublic static DurableTask Run<TState>(Func<TState, CancellationToken, Task> function, TState state)function with captured state.functionFunc<TState, CancellationToken, Task>stateTState[System.Obsolete(DurableTask.Run runs a delegate as a durable child, and a durable task already runs as one. Await the durable task directly., True)]public static DurableTask<TResult> Run<TResult>(Func<CancellationToken, DurableTask<TResult>> function)functionFunc<CancellationToken, DurableTask<TResult>>public static DurableTask<TResult> Run<TResult>(Func<CancellationToken, TResult> function)function as a child execution when it is awaited, scheduled, or posted.functionFunc<CancellationToken, TResult>public static DurableTask<TResult> Run<TResult>(Func<CancellationToken, Task<TResult>> function)function as a child execution when it is awaited, scheduled, or posted.functionFunc<CancellationToken, Task<TResult>>[System.Obsolete(DurableTask.Run runs a delegate as a durable child, and a durable task already runs as one. Await the durable task directly., True)]public static DurableTask<TResult> Run<TResult>(Func<DurableTask<TResult>> function)functionFunc<DurableTask<TResult>>public static DurableTask<TResult> Run<TResult>(Func<Task<TResult>> function)function when it is awaited, scheduled, or posted, possibly in a later turn, as a child execution with its own DurableTask and cancellation scope. Unlike System.Threading.Tasks.Task.Run, creating it starts nothing, and nothing runs on the thread pool. functionFunc<Task<TResult>>System.ArgumentNullExceptionfunction is null.public static DurableTask<TResult> Run<TResult>(Func<ValueTask<TResult>> function)function as a child execution when it is awaited, scheduled, or posted.functionFunc<ValueTask<TResult>>System.ArgumentNullExceptionfunction is null.public static DurableTask<TResult> Run<TState, TResult>(Func<TState, CancellationToken, TResult> function, TState state)function with captured state.functionFunc<TState, CancellationToken, TResult>stateTStatepublic static DurableTask<TResult> Run<TState, TResult>(Func<TState, CancellationToken, Task<TResult>> function, TState state)function with captured state.functionFunc<TState, CancellationToken, Task<TResult>>stateTStateprotected internal abstract ValueTask<DurableTaskResponse> RunAsync(DurableTaskContext context)contextDurableTaskContext[System.Obsolete(DurableTask.RunInline stores a synchronous result, and a durable task runs as a step. Await the durable task directly., True)]public static TResult RunInline<TResult>(Func<DurableTask<TResult>> effect)effectFunc<DurableTask<TResult>>public static TResult RunInline<TResult>(Func<TResult> effect)effect in the caller's current work item before returning, and records its outcome, which every later run of the task's body returns without running effect again. effectFunc<TResult>System.ArgumentNullExceptioneffect is null.System.InvalidOperationExceptionConfigureAwait(false). Orleans.Durable.Tasks.DurableTaskAttemptCanceledExceptionDurableTaskAttemptCancellationReason because an earlier run recorded another kind of operation, such as a step, under the effect's generated identifier. System.NotSupportedExceptionTResult is an asynchronous operation, such as a System.Threading.Tasks.Task, a System.Threading.Tasks.ValueTask, or a DurableTask, or the host doesn't support recorded effects. var paymentId = DurableTask.RunInline(Guid.NewGuid);[System.Obsolete(DurableTask.RunInline stores a synchronous result. For asynchronous work, use await DurableTask.Run(async () => ...)., True)]public static TResult RunInline<TResult>(Func<Task<TResult>> effect)DurableTask.RunInline can't record.effectFunc<Task<TResult>>[System.Obsolete(DurableTask.RunInline stores a synchronous result. For asynchronous work, use await DurableTask.Run(async () => ...)., True)]public static TResult RunInline<TResult>(Func<ValueTask<TResult>> effect)DurableTask.RunInline can't record.effectFunc<ValueTask<TResult>>[System.Obsolete(DurableTask.RunInline stores a synchronous result, and a durable task runs as a step. Await the durable task directly., True)]public static TResult RunInline<TResult>(string name, Func<DurableTask<TResult>> effect)namestringeffectFunc<DurableTask<TResult>>public static TResult RunInline<TResult>(string name, Func<TResult> effect)effect in the caller's current work item before returning, with no suspension and no child execution, and records its outcome in the same journal write as the journaled state which it changes. A replay returns the recorded outcome without running effect. namestringWithId identifies a step: the first occurrence of a name in one run is name, and later occurrences append their order, such as name$2, so an effect in a loop keeps one name. Effects and steps share one count per name, and an earlier run's step under the effect's identifier is a divergence. Names don't contain $. effectFunc<TResult>System.ArgumentNullExceptionname or effect is null.System.ArgumentExceptionname is empty or contains $.System.InvalidOperationExceptionConfigureAwait(false). Orleans.Durable.Tasks.DurableTaskAttemptCanceledExceptionDurableTaskAttemptCancellationReason because an earlier run recorded another kind of operation, such as a step, under the effect's identifier. System.NotSupportedExceptionTResult is an asynchronous operation, such as a System.Threading.Tasks.Task, a System.Threading.Tasks.ValueTask, or a DurableTask, or the host doesn't support recorded effects. var summary = DurableTask.RunInline("pay", () => SetStatus(OrderStatus.Paid)); var paymentId = DurableTask.RunInline("payment-id", Guid.NewGuid);[System.Obsolete(DurableTask.RunInline stores a synchronous result. For asynchronous work, use await DurableTask.Run(async () => ...)., True)]public static TResult RunInline<TResult>(string name, Func<Task<TResult>> effect)DurableTask.RunInline can't record.namestringeffectFunc<Task<TResult>>[System.Obsolete(DurableTask.RunInline stores a synchronous result. For asynchronous work, use await DurableTask.Run(async () => ...)., True)]public static TResult RunInline<TResult>(string name, Func<ValueTask<TResult>> effect)DurableTask.RunInline can't record.namestringeffectFunc<ValueTask<TResult>>public static void RunInline(Action effect)effect in the caller's current work item before returning, and records its outcome; later runs of the task's body don't run it again. effectActionSystem.ArgumentNullExceptioneffect is null.System.InvalidOperationExceptionConfigureAwait(false). Orleans.Durable.Tasks.DurableTaskAttemptCanceledExceptionDurableTaskAttemptCancellationReason because an earlier run recorded another kind of operation, such as a step, under the effect's generated identifier. System.NotSupportedException[System.Obsolete(DurableTask.RunInline stores a synchronous result, and a durable task runs as a step. Await the durable task directly., True)]public static void RunInline(Func<DurableTask> effect)effectFunc<DurableTask>[System.Obsolete(DurableTask.RunInline stores a synchronous result. For asynchronous work, use await DurableTask.Run(async () => ...)., True)]public static void RunInline(Func<Task> effect)DurableTask.RunInline can't record.effectFunc<Task>[System.Obsolete(DurableTask.RunInline stores a synchronous result. For asynchronous work, use await DurableTask.Run(async () => ...)., True)]public static void RunInline(Func<ValueTask> effect)DurableTask.RunInline can't record.effectFunc<ValueTask>public static void RunInline(string name, Action effect)effect in the caller's current work item before returning, and records its outcome; later runs of the task's body don't run it again. namestring$. effectActionSystem.ArgumentNullExceptionname or effect is null.System.ArgumentExceptionname is empty or contains $.System.InvalidOperationExceptionConfigureAwait(false). Orleans.Durable.Tasks.DurableTaskAttemptCanceledExceptionDurableTaskAttemptCancellationReason because an earlier run recorded another kind of operation, such as a step, under the effect's identifier. System.NotSupportedException[System.Obsolete(DurableTask.RunInline stores a synchronous result, and a durable task runs as a step. Await the durable task directly., True)]public static void RunInline(string name, Func<DurableTask> effect)namestringeffectFunc<DurableTask>[System.Obsolete(DurableTask.RunInline stores a synchronous result. For asynchronous work, use await DurableTask.Run(async () => ...)., True)]public static void RunInline(string name, Func<Task> effect)DurableTask.RunInline can't record.namestringeffectFunc<Task>[System.Obsolete(DurableTask.RunInline stores a synchronous result. For asynchronous work, use await DurableTask.Run(async () => ...)., True)]public static void RunInline(string name, Func<ValueTask> effect)DurableTask.RunInline can't record.namestringeffectFunc<ValueTask>public static DurableTask<ScheduledTask<TResult>[]> ScheduleAll<TResult>(IEnumerable<DurableTask<TResult>> tasks)tasksIEnumerable<DurableTask<TResult>>public static DurableTask<ScheduledTask<TResult>[]> ScheduleAll<TResult>(IReadOnlyList<DurableTask<TResult>> tasks)tasksIReadOnlyList<DurableTask<TResult>>public static DurableTask<ScheduledTask[]> ScheduleAll(IEnumerable<DurableTask> tasks)tasksIEnumerable<DurableTask>public static DurableTask<ScheduledTask[]> ScheduleAll(IReadOnlyList<DurableTask> tasks)tasksIReadOnlyList<DurableTask>public static DurableTask WhenAll(IEnumerable<DurableTask> tasks)tasksIEnumerable<DurableTask>public static DurableTask WhenAll(IReadOnlyList<DurableTask> tasks)tasksIReadOnlyList<DurableTask>public static DurableTask<TResult[]> WhenAll<TResult>(IEnumerable<DurableTask<TResult>> tasks)tasksIEnumerable<DurableTask<TResult>>public static DurableTask<TResult[]> WhenAll<TResult>(IReadOnlyList<DurableTask<TResult>> tasks)tasksIReadOnlyList<DurableTask<TResult>>public static DurableTask<ScheduledTask<TResult>[]> WhenAllCompleted<TResult>(IEnumerable<DurableTask<TResult>> tasks)tasksIEnumerable<DurableTask<TResult>>ScheduledTask, ScheduledTask, and Orleans.Durable.Tasks.ScheduledTask.TryGetResult inspect it. public static DurableTask<ScheduledTask<TResult>[]> WhenAllCompleted<TResult>(IReadOnlyList<DurableTask<TResult>> tasks)tasksIReadOnlyList<DurableTask<TResult>>ScheduledTask, ScheduledTask, and Orleans.Durable.Tasks.ScheduledTask.TryGetResult inspect it. public static DurableTask<ScheduledTask[]> WhenAllCompleted(IEnumerable<DurableTask> tasks)tasksIEnumerable<DurableTask>ScheduledTask, ScheduledTask, and Orleans.Durable.Tasks.ScheduledTask.TryGetResult inspect it. public static DurableTask<ScheduledTask[]> WhenAllCompleted(IReadOnlyList<DurableTask> tasks)tasksIReadOnlyList<DurableTask>ScheduledTask, ScheduledTask, and Orleans.Durable.Tasks.ScheduledTask.TryGetResult inspect it. public static DurableTask<(int Index, TResult Result)> DurableTask.WhenAny<TResult>(IEnumerable<DurableTask<TResult>> tasks)tasksIEnumerable<DurableTask<TResult>>System.ArgumentOutOfRangeExceptiontasks is empty.public static DurableTask<(int Index, TResult Result)> DurableTask.WhenAny<TResult>(IReadOnlyList<DurableTask<TResult>> tasks)tasksIReadOnlyList<DurableTask<TResult>>System.ArgumentOutOfRangeExceptiontasks is empty.public static DurableTask<int> WhenAny(IEnumerable<DurableTask> tasks)tasksIEnumerable<DurableTask>System.ArgumentOutOfRangeExceptiontasks is empty.public static DurableTask<int> WhenAny(IReadOnlyList<DurableTask> tasks)tasksIReadOnlyList<DurableTask>System.ArgumentOutOfRangeExceptiontasks is empty.public static IAsyncEnumerable<ScheduledTask<TResult>> WhenEach<TResult>(IEnumerable<DurableTask<TResult>> tasks)tasksIEnumerable<DurableTask<TResult>>System.InvalidOperationExceptionpublic static IAsyncEnumerable<ScheduledTask<TResult>> WhenEach<TResult>(IReadOnlyList<DurableTask<TResult>> tasks)tasksIReadOnlyList<DurableTask<TResult>>System.InvalidOperationExceptionpublic static IAsyncEnumerable<ScheduledTask> WhenEach(IEnumerable<DurableTask> tasks)tasksIEnumerable<DurableTask>System.InvalidOperationExceptionpublic static IAsyncEnumerable<ScheduledTask> WhenEach(IReadOnlyList<DurableTask> tasks)tasksIReadOnlyList<DurableTask>System.InvalidOperationException