ITaskFactory2.CreateTask Method (IBuildEngine, IDictionary<String, String>)

Create an instance of the task to be used, with an optional set of "special" parameters set on the individual task invocation using the MSBuildRuntime and MSBuildArchitecture default task parameters. MSBuild provides an implementation of this interface, TaskHostFactory, that uses "MSBuildRuntime", with values "CLR2", "CLR4", "CurrentRuntime", and "*" (Any); and "MSBuildArchitecture", with values "x86", "x64", "CurrentArchitecture", and "*" (Any). An implementer of ITaskFactory2 can choose to use these pre-defined MSBuildRuntime and MSBuildArchitecture values, or can specify new values for these parameters.

MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Namespace:  Microsoft.Build.Framework
Assembly:  Microsoft.Build.Framework (in Microsoft.Build.Framework.dll)

Syntax

'Declaration
Function CreateTask ( _
    taskFactoryLoggingHost As IBuildEngine, _
    taskIdentityParameters As IDictionary(Of String, String) _
) As ITask

ITask CreateTask(
    IBuildEngine taskFactoryLoggingHost,
    IDictionary<string, string> taskIdentityParameters
)

ITask^ CreateTask(
    IBuildEngine^ taskFactoryLoggingHost, 
    IDictionary<String^, String^>^ taskIdentityParameters
)

abstract CreateTask : 
        taskFactoryLoggingHost:IBuildEngine * 
        taskIdentityParameters:IDictionary<string, string> -> ITask

function CreateTask(
    taskFactoryLoggingHost : IBuildEngine, 
    taskIdentityParameters : IDictionary<String, String>
) : ITask

Parameters

• taskFactoryLoggingHost
  Type: Microsoft.Build.Framework.IBuildEngine

  The task factory logging host will log messages in the context of the task.

• taskIdentityParameters
  Type: IDictionary<String, String>

  Special parameters that the task factory can use to modify how it executes tasks, such as Runtime and Architecture.

Return Value

Type: Microsoft.Build.Framework.ITask
The generated task, or null if the task failed to be created.

Remarks

If a task factory implements ITaskFactory2, MSBuild will call this method instead of ITaskFactory.CreateTask.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.

See Also

Reference

ITaskFactory2 Interface

CreateTask Overload

Microsoft.Build.Framework Namespace