Task<TResult>.ContinueWith<TNewResult> Method (Func<Task<TResult>, TNewResult>, CancellationToken)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Creates a continuation that executes asynchronously when the target Task<TResult> completes.
Namespace: System.Threading.Tasks
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Function ContinueWith(Of TNewResult) ( _
continuationFunction As Func(Of Task(Of TResult), TNewResult), _
cancellationToken As CancellationToken _
) As Task(Of TNewResult)
public Task<TNewResult> ContinueWith<TNewResult>(
Func<Task<TResult>, TNewResult> continuationFunction,
CancellationToken cancellationToken
)
Type Parameters
- TNewResult
The type of the result produced by the continuation.
Parameters
- continuationFunction
Type: System.Func<Task<TResult>, TNewResult>
A function to run when the Task<TResult> completes. When run, the delegate will be passed the completed task as an argument.
- cancellationToken
Type: System.Threading.CancellationToken
The CancellationToken that will be assigned to the new task.
Return Value
Type: System.Threading.Tasks.Task<TNewResult>
A new continuation Task<TResult>.
Exceptions
Exception | Condition |
---|---|
ObjectDisposedException | The Task<TResult> has been disposed. -or- The CancellationTokenSource that created cancellationToken has already been disposed. |
ArgumentNullException | The continuationFunction argument is null. |
Remarks
The returned Task<TResult> will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled.
Version Information
Silverlight
Supported in: 5
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also
Reference
Other Resources
Change History
Date |
History |
Reason |
---|---|---|
Added text to clarify asynchronous execution of continuations. |
Customer feedback. |