TaskFactory Constructor (CancellationToken, TaskCreationOptions, TaskContinuationOptions, TaskScheduler)

July 28, 2014

Initializes a TaskFactory instance with the specified configuration.

Namespace:  System.Threading.Tasks
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.

ExceptionCondition
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).

Windows Phone OS

Supported in: 8.1, 8.0

Show:
© 2014 Microsoft