# DurableTaskContext

Package: [Microsoft.Orleans.Durable.Abstractions](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/) 10.0.0-alpha.1

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable.Abstractions/DurableTaskContext.cs#L22)

```csharp
public abstract class DurableTaskContext
```

Describes a running durable task and supplies its host's services.

## Remarks

Task code reads the running task's context from [DurableTask](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletask/). Hosts derive from this type to schedule and record the task's operations.

An execution's code runs on one scheduler, the one which was current when the host created the context, such as its grain activation's scheduler, so the context's state needs no synchronization. The host creates the context, requests task cancellation, and cancels the attempt on that scheduler, and the execution's code allocates identifiers and runs effects there: an operation which code runs elsewhere, for example after `ConfigureAwait(false)`, throws `System.InvalidOperationException`. The cancellation tokens and the handles which the execution observes remain safe to use from any thread.

## Constructors

- [DurableTaskContext(TaskId)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/constructors/constructor-orleans-durable-tasks-taskid-5c647bec/)

## Properties

- [AttemptCancellationReason](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/attemptcancellationreason-a251d9d4/)
- [AttemptCancellationToken](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/attemptcancellationtoken-0bf454e2/)
- [CancellationToken](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/cancellationtoken-c8a6695b/)
- [HostId](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/hostid-f09488f9/)
- [Id](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/id-44043fd0/)
- [Incarnation](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/incarnation-51a76cbe/)
- [IsAttemptCanceled](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/isattemptcanceled-e00b1357/)
- [IsReplaying](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/isreplaying-f12c1531/)
- [IsTaskCancellationRequested](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/istaskcancellationrequested-8e932079/)
- [SchedulesShieldedChildren](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/schedulesshieldedchildren-b93a4c1c/)
- [TaskCancellationReason](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/taskcancellationreason-6e919509/)
- [UtcNow](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/properties/utcnow-483b97a3/)

## Methods

- [CancelAttempt(DurableTaskAttemptCancellationReason)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/cancelattempt-orleans-durable-tasks-durabletaskattemptcancellationreason-0153037f/)
- [CreateAttemptCanceledException(Exception?)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/createattemptcanceledexception-system-exception-nullable-687340b1/)
- [GetVersion(string, int, int)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/getversion-string-int-int-6367a786/)
- [OnBodyCompleted(DurableTaskResponse)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/onbodycompleted-orleans-durable-tasks-durabletaskresponse-2e7b5aed/)
- [PostTask(TaskId, DurableTask, DurableTaskStartOptions)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/posttask-orleans-durable-tasks-taskid-orleans-durable-tasks-durabletask-orleans-280313ff/)
- [RequestTaskCancellation(string?)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/requesttaskcancellation-string-nullable-e5ed6a21/)
- [RunEffect(TaskId, TState, Func&lt;TState, DurableTaskResponse&gt;)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/runeffect-1-orleans-durable-tasks-taskid-tstate-system-func-tstate-orleans-durab-75beacc0/)
- [ScheduleDelayAsync(TaskId, DateTimeOffset, CancellationToken)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/scheduledelayasync-orleans-durable-tasks-taskid-system-datetimeoffset-system-thr-8b3723ce/)
- [SelectCompletionAsync(TaskId, IReadOnlyList&lt;TaskId&gt;, CancellationToken)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/selectcompletionasync-orleans-durable-tasks-taskid-system-collections-generic-ir-fe215518/)
- [StartTaskAsync(TaskId, DurableTask, DurableTaskStartOptions, CancellationToken)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/starttaskasync-orleans-durable-tasks-taskid-orleans-durable-tasks-durabletask-or-f1b3e8f2/)
- [TryGetCurrent(DurableTaskContext?)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/trygetcurrent-out-orleans-durable-tasks-durabletaskcontext-nullable-e2be543b/)
- [WaitForSignalAsync(string, CancellationToken)](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletaskcontext/methods/waitforsignalasync-string-system-threading-cancellationtoken-4117bac4/)
