Task Constructor (Action<Object^>^, Object^)

.NET Framework (current version)

Initializes a new Task with the specified action and state.

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

Syntax

public:
Task(
	Action<Object^>^ action,
	Object^ state
)

Parameters

action: Type: System::Action<Object^>^
The delegate that represents the code to execute in the task.

state: Type: System::Object^
An object representing data to be used by the action.

Exceptions

Exception	Condition
ArgumentNullException	The action argument is null.

Rather than calling this constructor, the most common way to instantiate a Task object and launch a task is by calling the static TaskFactory::StartNew(Action<Object^>^, Object^) method. The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Examples

The following example defines an array of 6-letter words. Each word is then passed as an argument to the Task(Action<Object^>^, Object^) constructor, whose Action<T> delegate scrambles the characters in the word, then displays the original word and its scrambled version.

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