TaskCompletionSource<TResult>.TrySetException Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Attempts to transition the underlying Task<TResult> object into the Faulted state.
| TrySetException(IEnumerable<Exception>) |
Attempts to transition the underlying Task<TResult> into the Faulted state and binds a collection of exception objects to it. |
| TrySetException(Exception) |
Attempts to transition the underlying Task<TResult> into the Faulted state and binds it to a specified exception. |
- Source:
- TaskCompletionSource_T.cs
- Source:
- TaskCompletionSource_T.cs
- Source:
- TaskCompletionSource_T.cs
Attempts to transition the underlying Task<TResult> into the Faulted state and binds a collection of exception objects to it.
public:
bool TrySetException(System::Collections::Generic::IEnumerable<Exception ^> ^ exceptions);public bool TrySetException(System.Collections.Generic.IEnumerable<Exception> exceptions);member this.TrySetException : seq<Exception> -> boolPublic Function TrySetException (exceptions As IEnumerable(Of Exception)) As BooleanParameters
- exceptions
- IEnumerable<Exception>
The collection of exceptions to bind to this Task<TResult>.
Returns
true if the operation was successful; otherwise, false.
Exceptions
The Task was disposed.
The exceptions argument is null.
There are one or more null elements in exceptions.
-or-
The exceptions collection is empty.
Remarks
This operation will return false if the Task<TResult> is already in one of the three final states: RanToCompletion, Faulted, or Canceled.
See also
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- TaskCompletionSource_T.cs
- Source:
- TaskCompletionSource_T.cs
- Source:
- TaskCompletionSource_T.cs
Attempts to transition the underlying Task<TResult> into the Faulted state and binds it to a specified exception.
public:
bool TrySetException(Exception ^ exception);public bool TrySetException(Exception exception);member this.TrySetException : Exception -> boolPublic Function TrySetException (exception As Exception) As BooleanParameters
- exception
- Exception
The exception to bind to this Task<TResult>.
Returns
true if the operation was successful; otherwise, false.
Exceptions
The Task was disposed.
The exception argument is null.
Remarks
This operation will return false if the Task<TResult> is already in one of the three final states: RanToCompletion, Faulted, or Canceled.
See also
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: