Task Constructor (Action<Object^>^, Object^, TaskCreationOptions)
.NET Framework (current version)
Initializes a new Task with the specified action, state, and options.
Assembly: mscorlib (in mscorlib.dll)
public:
Task(
Action<Object^>^ action,
Object^ state,
TaskCreationOptions creationOptions
)
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.
- creationOptions
-
Type:
System.Threading.Tasks::TaskCreationOptions
The TaskCreationOptions used to customize the task's behavior.
| Exception | Condition |
|---|---|
| ArgumentNullException | The action argument is null. |
| ArgumentOutOfRangeException | The creationOptions argument specifies an invalid value for TaskCreationOptions. |
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^, TaskCreationOptions) method. The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.
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
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
Show: