# DurableTaskGrainExtensions Methods

[Type overview](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/)

## GetDurableTask(IAddressable, TaskId) {#getdurabletask-1-this-orleans-runtime-iaddressable-orleans-durable-tasks-taskid-1dc770c1}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/methods/getdurabletask-1-this-orleans-runtime-iaddressable-orleans-durable-tasks-taskid-1dc770c1/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/DurableTasks/DurableTaskGrainExtensions.cs#L255-L261)

```csharp
public static DurableTaskReference<TResult> GetDurableTask<TResult>(this IAddressable target, TaskId taskId)
```

Gets a reference to the existing durable task `taskId` on `target`, without scheduling it.

### Parameters

- `target` (`IAddressable`): The grain which owns the durable task, which can be the calling grain.
- `taskId` (`TaskId`): The identifier of a task which a client, a grain, or a durable execution started.

### Returns

A reference which a durable execution awaits, schedules, or passes to combinators to subscribe to the task's result, and which other code awaits, polls, cancels, or aborts.

### Exceptions

- `System.ArgumentNullException`: `target` is `null`.
- `System.ArgumentException`: `taskId` is empty.

## GetDurableTask(IAddressable, string) {#getdurabletask-1-this-orleans-runtime-iaddressable-string-3ed0b66b}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/methods/getdurabletask-1-this-orleans-runtime-iaddressable-string-3ed0b66b/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/DurableTasks/DurableTaskGrainExtensions.cs#L207-L209)

```csharp
public static DurableTaskReference<TResult> GetDurableTask<TResult>(this IAddressable target, string rootId)
```

Gets a reference to the existing root durable task `rootId` on `target`, without scheduling it.

### Parameters

- `target` (`IAddressable`): The grain which owns the durable task, which can be the calling grain.
- `rootId` (`string`): The root ID of a task which a client, a grain, or a durable execution started.

### Returns

A reference which behaves as [DurableTaskGrainExtensions](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/) describes.

### Exceptions

- `System.ArgumentNullException`: `target` is `null`.
- `System.ArgumentException`: `rootId` is empty or whitespace.

## SignalDurableTaskAsync(IAddressable, TaskId, DurableSignal&lt;T&gt;, T, CancellationToken) {#signaldurabletaskasync-1-this-orleans-runtime-iaddressable-orleans-durable-tasks-6610f061}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/methods/signaldurabletaskasync-1-this-orleans-runtime-iaddressable-orleans-durable-tasks-6610f061/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/DurableTasks/DurableTaskGrainExtensions.cs#L83-L93)

```csharp
public static ValueTask SignalDurableTaskAsync<T>(this IAddressable target, TaskId taskId, DurableSignal<T> signal, T value, CancellationToken cancellationToken = default(CancellationToken))
```

Delivers `signal` with `value` to the invoked task `taskId` on `target`.

### Parameters

- `target` (`IAddressable`): The grain which owns the task.
- `taskId` (`TaskId`): The identifier of a task which a client or another grain invoked on `target`.
- `signal` (`DurableSignal<T>`): The signal descriptor which the task's waits share.
- `value` (`T`): The signal's value.
- `cancellationToken` (`CancellationToken`): A token which abandons the send.

### Returns

An operation which completes once the send is durable.

### Exceptions

- `System.ArgumentNullException`: `target` or `signal` is `null`.
- `System.ArgumentException`: `taskId` is empty.
- `Orleans.Durable.Tasks.DurableTaskNotFoundException`: Outside a durable execution, the target retains no invoked task `taskId`.
- `System.InvalidOperationException`: Outside a durable execution, the task holds a different value for the signal, or it is terminal and holds no value for the signal.

## SignalDurableTaskAsync(IAddressable, string, DurableSignal&lt;T&gt;, T, CancellationToken) {#signaldurabletaskasync-1-this-orleans-runtime-iaddressable-string-orleans-durabl-be52caeb}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/methods/signaldurabletaskasync-1-this-orleans-runtime-iaddressable-string-orleans-durabl-be52caeb/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/DurableTasks/DurableTaskGrainExtensions.cs#L123)

```csharp
public static ValueTask SignalDurableTaskAsync<T>(this IAddressable target, string rootId, DurableSignal<T> signal, T value, CancellationToken cancellationToken = default(CancellationToken))
```

Delivers `signal` with `value` to the root task `rootId` on `target`.

### Parameters

- `target` (`IAddressable`): The grain which owns the task.
- `rootId` (`string`): The root ID of a task which a client, a grain, or a durable execution started.
- `signal` (`DurableSignal<T>`): The signal descriptor which the task's waits share.
- `value` (`T`): The signal's value.
- `cancellationToken` (`CancellationToken`): A token which abandons the send.

### Returns

A task which completes as [DurableTaskGrainExtensions](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/) describes.

## TryGetTarget(DurableTask, GrainId) {#trygettarget-this-orleans-durable-tasks-durabletask-out-orleans-runtime-grainid-7aad201e}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/methods/trygettarget-this-orleans-durable-tasks-durabletask-out-orleans-runtime-grainid-7aad201e/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/DurableTasks/DurableTaskGrainExtensions.cs#L34-L42)

```csharp
public static bool TryGetTarget(this DurableTask task, out GrainId target)
```

Gets the grain which a durable grain call targets, before the call is scheduled.

### Parameters

- `task` (`DurableTask`): The durable task definition.
- `target` (`GrainId`): The grain which the call targets, when this method returns `true`; otherwise `default`.

### Returns

`true` when `task` is a call to a grain's [DurableTask](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletask/)-returning method, made through a grain reference and not yet scheduled; otherwise `false`, such as for a local definition like [DurableTask](/orleans/docs/api/csharp/microsoft.orleans.durable.abstractions/orleans.durable.tasks.durabletask/) or a reference to an existing task.

### Exceptions

- `System.ArgumentNullException`: `task` is `null`.

## TrySignalDurableTaskAsync(IAddressable, TaskId, DurableSignal&lt;T&gt;, T, CancellationToken) {#trysignaldurabletaskasync-1-this-orleans-runtime-iaddressable-orleans-durable-ta-945c62a6}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/methods/trysignaldurabletaskasync-1-this-orleans-runtime-iaddressable-orleans-durable-ta-945c62a6/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/DurableTasks/DurableTaskGrainExtensions.cs#L157-L171)

```csharp
public static ValueTask<DurableSignalResult> TrySignalDurableTaskAsync<T>(this IAddressable target, TaskId taskId, DurableSignal<T> signal, T value, CancellationToken cancellationToken = default(CancellationToken))
```

Delivers `signal` with `value` to the invoked task `taskId` on `target`, and returns how the task handled it.

### Parameters

- `target` (`IAddressable`): The grain which owns the task.
- `taskId` (`TaskId`): The identifier of a task which a client or another grain invoked on `target`.
- `signal` (`DurableSignal<T>`): The signal descriptor which the task's waits share.
- `value` (`T`): The signal's value.
- `cancellationToken` (`CancellationToken`): A token which abandons the send.

### Returns

[DurableSignalResult](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durablesignalresult/) or [DurableSignalResult](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durablesignalresult/) once the task durably holds the value, or the reason the task rejected it, which changes nothing.

### Exceptions

- `System.ArgumentNullException`: `target` or `signal` is `null`.
- `System.ArgumentException`: `taskId` is empty.
- `System.InvalidOperationException`: The caller is a durable execution.

## TrySignalDurableTaskAsync(IAddressable, string, DurableSignal&lt;T&gt;, T, CancellationToken) {#trysignaldurabletaskasync-1-this-orleans-runtime-iaddressable-string-orleans-dur-6f12fc90}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/methods/trysignaldurabletaskasync-1-this-orleans-runtime-iaddressable-string-orleans-dur-6f12fc90/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/DurableTasks/DurableTaskGrainExtensions.cs#L192)

```csharp
public static ValueTask<DurableSignalResult> TrySignalDurableTaskAsync<T>(this IAddressable target, string rootId, DurableSignal<T> signal, T value, CancellationToken cancellationToken = default(CancellationToken))
```

Delivers `signal` with `value` to the root task `rootId` on `target`, and returns how the task handled it.

### Parameters

- `target` (`IAddressable`): The grain which owns the task.
- `rootId` (`string`): The root ID of a task which a client, a grain, or a durable execution started.
- `signal` (`DurableSignal<T>`): The signal descriptor which the task's waits share.
- `value` (`T`): The signal's value.
- `cancellationToken` (`CancellationToken`): A token which abandons the send.

### Returns

The task's handling of the signal, as [DurableTaskGrainExtensions](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskgrainextensions/) returns.
