TaskFactory Constructor (CancellationToken, TaskCreationOptions, TaskContinuationOptions, TaskScheduler)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Initializes a TaskFactory instance with the specified configuration.
Assembly: mscorlib (in mscorlib.dll)
public TaskFactory(
CancellationToken cancellationToken,
TaskCreationOptions creationOptions,
TaskContinuationOptions continuationOptions,
TaskScheduler scheduler
)
Parameters
- cancellationToken
- Type: System.Threading.CancellationToken
The default CancellationToken that will be assigned to tasks created by this TaskFactory unless another CancellationToken is explicitly specified while calling the factory methods.
- creationOptions
- Type: System.Threading.Tasks.TaskCreationOptions
The default TaskCreationOptions to use when creating tasks with this TaskFactory.
- continuationOptions
- Type: System.Threading.Tasks.TaskContinuationOptions
The default TaskContinuationOptions to use when creating continuation tasks with this TaskFactory.
- scheduler
- Type: System.Threading.Tasks.TaskScheduler
The default TaskScheduler to use to schedule any Tasks created with this TaskFactory. A null value indicates that TaskScheduler.Current should be used.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The exception that is thrown when the creationOptions argument or the continuationOptions argument specifies an invalid value. The exception that is thrown when the creationOptions argument specifies an invalid TaskCreationOptions value. For more information, see the Remarks for FromAsync |
With this constructor, the TaskCreationOptions property is initialized to creationOptions, the TaskContinuationOptions property is initialized to continuationOptions, and the TaskScheduler property is initialized to scheduler, unless it's null, in which case the property is initialized to the current scheduler (see Current).