TaskCompletionSource<TResult>.TrySetException Method (Exception)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Attempts to transition the underlying Task<TResult> into the Faulted state and binds it to a specified exception.

Namespace:   System.Threading.Tasks
Assembly:  mscorlib (in mscorlib.dll)

public bool TrySetException(
	Exception exception


Type: System.Exception

The exception to bind to this Task<TResult>.

Return Value

Type: System.Boolean

True if the operation was successful; otherwise, false.

Exception Condition

The Task was disposed.


The exception argument is null.

This operation will return false if the Task<TResult> is already in one of the three final states: RanToCompletion, Faulted, or Canceled.

Universal Windows Platform
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Available since 5.0
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1
Return to top