The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

TaskFactory Class

.NET Framework (current version)

Other Versions

Provides support for creating and scheduling Task objects.

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

Inheritance Hierarchy

System::Object
System.Threading.Tasks::TaskFactory

Syntax

C++

[HostProtectionAttribute(SecurityAction::LinkDemand, Synchronization = true, 
	ExternalThreading = true)]
public ref class TaskFactory

Constructors

	Name	Description
	TaskFactory()	Initializes a TaskFactory instance with the default configuration.
	TaskFactory(CancellationToken)	Initializes a TaskFactory instance with the specified configuration.
	TaskFactory(CancellationToken, TaskCreationOptions, TaskContinuationOptions, TaskScheduler^)	Initializes a TaskFactory instance with the specified configuration.
	TaskFactory(TaskCreationOptions, TaskContinuationOptions)	Initializes a TaskFactory instance with the specified configuration.
	TaskFactory(TaskScheduler^)	Initializes a TaskFactory instance with the specified configuration.

Properties

	Name	Description
	CancellationToken	Gets the default cancellation token for this task factory.
	ContinuationOptions	Gets the default task continuation options for this task factory.
	CreationOptions	Gets the default task creation options for this task factory.
	Scheduler	Gets the default task scheduler for this task factory.

Methods

	Name	Description
	ContinueWhenAll(array<Task^>^, Action<array<Task^>^>^)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll(array<Task^>^, Action<array<Task^>^>^, CancellationToken)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll(array<Task^>^, Action<array<Task^>^>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll(array<Task^>^, Action<array<Task^>^>^, TaskContinuationOptions)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TResult>(array<Task^>^, Func<array<Task^>^, TResult>^)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TResult>(array<Task^>^, Func<array<Task^>^, TResult>^, CancellationToken)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TResult>(array<Task^>^, Func<array<Task^>^, TResult>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TResult>(array<Task^>^, Func<array<Task^>^, TResult>^, TaskContinuationOptions)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TAntecedentResult>(array<Task<TAntecedentResult>^>^, Action<array<Task<TAntecedentResult>^>^>^)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TAntecedentResult>(array<Task<TAntecedentResult>^>^, Action<array<Task<TAntecedentResult>^>^>^, CancellationToken)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TAntecedentResult>(array<Task<TAntecedentResult>^>^, Action<array<Task<TAntecedentResult>^>^>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TAntecedentResult>(array<Task<TAntecedentResult>^>^, Action<array<Task<TAntecedentResult>^>^>^, TaskContinuationOptions)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TAntecedentResult, TResult>(array<Task<TAntecedentResult>^>^, Func<array<Task<TAntecedentResult>^>^, TResult>^)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TAntecedentResult, TResult>(array<Task<TAntecedentResult>^>^, Func<array<Task<TAntecedentResult>^>^, TResult>^, CancellationToken)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TAntecedentResult, TResult>(array<Task<TAntecedentResult>^>^, Func<array<Task<TAntecedentResult>^>^, TResult>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAll<TAntecedentResult, TResult>(array<Task<TAntecedentResult>^>^, Func<array<Task<TAntecedentResult>^>^, TResult>^, TaskContinuationOptions)	Creates a continuation task that starts when a set of specified tasks has completed.
	ContinueWhenAny(array<Task^>^, Action<Task^>^)	Creates a continuation Task that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny(array<Task^>^, Action<Task^>^, CancellationToken)	Creates a continuation Task that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny(array<Task^>^, Action<Task^>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)	Creates a continuation Task that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny(array<Task^>^, Action<Task^>^, TaskContinuationOptions)	Creates a continuation Task that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TResult>(array<Task^>^, Func<Task^, TResult>^)	Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TResult>(array<Task^>^, Func<Task^, TResult>^, CancellationToken)	Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TResult>(array<Task^>^, Func<Task^, TResult>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)	Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TResult>(array<Task^>^, Func<Task^, TResult>^, TaskContinuationOptions)	Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TAntecedentResult>(array<Task<TAntecedentResult>^>^, Action<Task<TAntecedentResult>^>^)	Creates a continuation Task that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TAntecedentResult>(array<Task<TAntecedentResult>^>^, Action<Task<TAntecedentResult>^>^, CancellationToken)	Creates a continuation Task that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TAntecedentResult>(array<Task<TAntecedentResult>^>^, Action<Task<TAntecedentResult>^>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)	Creates a continuation Task that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TAntecedentResult>(array<Task<TAntecedentResult>^>^, Action<Task<TAntecedentResult>^>^, TaskContinuationOptions)	Creates a continuation Task that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TAntecedentResult, TResult>(array<Task<TAntecedentResult>^>^, Func<Task<TAntecedentResult>^, TResult>^)	Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TAntecedentResult, TResult>(array<Task<TAntecedentResult>^>^, Func<Task<TAntecedentResult>^, TResult>^, CancellationToken)	Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TAntecedentResult, TResult>(array<Task<TAntecedentResult>^>^, Func<Task<TAntecedentResult>^, TResult>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)	Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.
	ContinueWhenAny<TAntecedentResult, TResult>(array<Task<TAntecedentResult>^>^, Func<Task<TAntecedentResult>^, TResult>^, TaskContinuationOptions)	Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	FromAsync(Func<AsyncCallback^, Object^, IAsyncResult^>^, Action<IAsyncResult^>^, Object^)	Creates a Task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync(Func<AsyncCallback^, Object^, IAsyncResult^>^, Action<IAsyncResult^>^, Object^, TaskCreationOptions)	Creates a Task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync(IAsyncResult^, Action<IAsyncResult^>^)	Creates a Task that executes an end method action when a specified IAsyncResult completes.
	FromAsync(IAsyncResult^, Action<IAsyncResult^>^, TaskCreationOptions)	Creates a Task that executes an end method action when a specified IAsyncResult completes.
	FromAsync(IAsyncResult^, Action<IAsyncResult^>^, TaskCreationOptions, TaskScheduler^)	Creates a Task that executes an end method action when a specified IAsyncResult completes.
	FromAsync<TArg1>(Func<TArg1, AsyncCallback^, Object^, IAsyncResult^>^, Action<IAsyncResult^>^, TArg1, Object^)	Creates a Task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1>(Func<TArg1, AsyncCallback^, Object^, IAsyncResult^>^, Action<IAsyncResult^>^, TArg1, Object^, TaskCreationOptions)	Creates a Task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TResult>(Func<AsyncCallback^, Object^, IAsyncResult^>^, Func<IAsyncResult^, TResult>^, Object^)	Creates a Task<TResult> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TResult>(Func<AsyncCallback^, Object^, IAsyncResult^>^, Func<IAsyncResult^, TResult>^, Object^, TaskCreationOptions)	Creates a Task<TResult> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TResult>(IAsyncResult^, Func<IAsyncResult^, TResult>^)	Creates a Task<TResult> that executes an end method function when a specified IAsyncResult completes.
	FromAsync<TResult>(IAsyncResult^, Func<IAsyncResult^, TResult>^, TaskCreationOptions)	Creates a Task<TResult> that executes an end method function when a specified IAsyncResult completes.
	FromAsync<TResult>(IAsyncResult^, Func<IAsyncResult^, TResult>^, TaskCreationOptions, TaskScheduler^)	Creates a Task<TResult> that executes an end method function when a specified IAsyncResult completes.
	FromAsync<TArg1, TArg2>(Func<TArg1, TArg2, AsyncCallback^, Object^, IAsyncResult^>^, Action<IAsyncResult^>^, TArg1, TArg2, Object^)	Creates a Task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TArg2>(Func<TArg1, TArg2, AsyncCallback^, Object^, IAsyncResult^>^, Action<IAsyncResult^>^, TArg1, TArg2, Object^, TaskCreationOptions)	Creates a Task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TResult>(Func<TArg1, AsyncCallback^, Object^, IAsyncResult^>^, Func<IAsyncResult^, TResult>^, TArg1, Object^)	Creates a Task<TResult> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TResult>(Func<TArg1, AsyncCallback^, Object^, IAsyncResult^>^, Func<IAsyncResult^, TResult>^, TArg1, Object^, TaskCreationOptions)	Creates a Task<TResult> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TArg2, TArg3>(Func<TArg1, TArg2, TArg3, AsyncCallback^, Object^, IAsyncResult^>^, Action<IAsyncResult^>^, TArg1, TArg2, TArg3, Object^)	Creates a Task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TArg2, TArg3>(Func<TArg1, TArg2, TArg3, AsyncCallback^, Object^, IAsyncResult^>^, Action<IAsyncResult^>^, TArg1, TArg2, TArg3, Object^, TaskCreationOptions)	Creates a Task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TArg2, TResult>(Func<TArg1, TArg2, AsyncCallback^, Object^, IAsyncResult^>^, Func<IAsyncResult^, TResult>^, TArg1, TArg2, Object^)	Creates a Task<TResult> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TArg2, TResult>(Func<TArg1, TArg2, AsyncCallback^, Object^, IAsyncResult^>^, Func<IAsyncResult^, TResult>^, TArg1, TArg2, Object^, TaskCreationOptions)	Creates a Task<TResult> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TArg2, TArg3, TResult>(Func<TArg1, TArg2, TArg3, AsyncCallback^, Object^, IAsyncResult^>^, Func<IAsyncResult^, TResult>^, TArg1, TArg2, TArg3, Object^)	Creates a Task<TResult> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	FromAsync<TArg1, TArg2, TArg3, TResult>(Func<TArg1, TArg2, TArg3, AsyncCallback^, Object^, IAsyncResult^>^, Func<IAsyncResult^, TResult>^, TArg1, TArg2, TArg3, Object^, TaskCreationOptions)	Creates a Task<TResult> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	StartNew(Action^)	Creates and starts a task.
	StartNew(Action^, CancellationToken)	Creates and starts a Task.
	StartNew(Action^, CancellationToken, TaskCreationOptions, TaskScheduler^)	Creates and starts a Task.
	StartNew(Action^, TaskCreationOptions)	Creates and starts a Task.
	StartNew(Action<Object^>^, Object^)	Creates and starts a Task.
	StartNew(Action<Object^>^, Object^, CancellationToken)	Creates and starts a Task.
	StartNew(Action<Object^>^, Object^, CancellationToken, TaskCreationOptions, TaskScheduler^)	Creates and starts a Task.
	StartNew(Action<Object^>^, Object^, TaskCreationOptions)	Creates and starts a Task.
	StartNew<TResult>(Func<TResult>^)	Creates and starts a Task<TResult>.
	StartNew<TResult>(Func<TResult>^, CancellationToken)	Creates and starts a Task<TResult>.
	StartNew<TResult>(Func<TResult>^, CancellationToken, TaskCreationOptions, TaskScheduler^)	Creates and starts a Task<TResult>.
	StartNew<TResult>(Func<TResult>^, TaskCreationOptions)	Creates and starts a Task<TResult>.
	StartNew<TResult>(Func<Object^, TResult>^, Object^)	Creates and starts a Task<TResult>.
	StartNew<TResult>(Func<Object^, TResult>^, Object^, CancellationToken)	Creates and starts a Task<TResult>.
	StartNew<TResult>(Func<Object^, TResult>^, Object^, CancellationToken, TaskCreationOptions, TaskScheduler^)	Creates and starts a Task<TResult>.
	StartNew<TResult>(Func<Object^, TResult>^, Object^, TaskCreationOptions)	Creates and starts a Task<TResult>.
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

Remarks

The .NET Framework provides two factories for creating and scheduling tasks:

The TaskFactory class, which creates Task and Task<TResult> objects. You can call the overloads of this method to create and execute a task that requires non-default arguments.
Warning
Starting with the .NET Framework 4.5, the Task::Run method provides the easiest way to create a task with default configuration values and start it immediately.
The TaskFactory<TResult> class, which creates Task<TResult> objects.

Warning
Starting with the .NET Framework 4.5, the Task::Run method provides the easiest way to create a task with default configuration values and start it immediately.

The TaskFactory class allows you to do the following:

Create a task and start it immediately by calling the StartNew method.
Warning
Starting with the .NET Framework 4.5, the Task::Run method provides the easiest way to create a task with default configuration values and start it immediately.
Create a task that starts when any one of the tasks in an array has completed by calling the ContinueWhenAny method.
Create a task that starts when all the tasks in an array have completed by calling the ContinueWhenAll method.

Warning
Starting with the .NET Framework 4.5, the Task::Run method provides the easiest way to create a task with default configuration values and start it immediately.

The static Task<TResult>::Factory property returns a default TaskFactory<TResult> object. You can also call one of the TaskFactory class constructors to configure the Task objects that the TaskFactory class creates. The following example configures a new TaskFactory object to create tasks that have a specified cancellation token, task creation options, continuation options, and a customized task scheduler.

C++

No code example is currently available or this language may not be supported.

In most cases, you do not have to instantiate a new TaskFactory instance. Instead, you can use the Task::Factory property, which returns a factory object that uses default values. You can then call its methods to start new tasks or define task continuations. For an illustration, see the example.

Examples

The following example uses the static Factory property to make two calls to the TaskFactory::StartNew method. The first populates an array with the names of files in the user's MyDocuments directory, while the second populates an array with the names of subdirectories of the user's MyDocuments directory. It then calls the TaskFactory::ContinueWhenAll(array<Task^>^, Action<array<Task^>^>^) method, which displays information about the number of files and directories in the two arrays after the first two tasks have completed execution.

C++

No code example is currently available or this language may not be supported.

Version Information

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

Thread Safety

All public and protected members of TaskFactory are thread-safe and may be used concurrently from multiple threads.

Deutsch	English	Español	Français
Italiano	日本語	한국어	Português
Pусский	简体中文	繁體中文