This documentation is archived and is not being maintained.

TaskFactory Constructor (CancellationToken, TaskCreationOptions, TaskContinuationOptions, TaskScheduler)

Initializes a new instance of the TaskFactory class 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 cancellation token that will be assigned to tasks created by this TaskFactory unless another cancellation token is explicitly specified while calling the factory methods.
creationOptions
Type: System.Threading.Tasks.TaskCreationOptions
The bitwise combination of the default enumeration values to use when creating tasks with this task factory.

continuationOptions
Type: System.Threading.Tasks.TaskContinuationOptions
A bitwise combination of the default enumeration values to use when creating continuation tasks with this task factory.

scheduler
Type: System.Threading.Tasks.TaskScheduler
The default scheduler to use for any tasks created with this task factory. A null value indicates that Current should be used.

ExceptionCondition
ArgumentOutOfRangeException

The creationOptions argument specifies an invalid value.

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

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: