CreateProperty Task

Populates properties with the values passed in. This allows values to be copied from one property or string to another.

Attributes

The following table describes the parameters of the CreateProperty task.

Parameter

Description

Value

Optional String output parameter.

Specifies the value to copy to the new property.

ValueSetByTask

Optional String output parameter.

Contains the same value as the Value parameter. Use this parameter only when you want to avoid having the output property set by MSBuild when it skips the enclosing target because the outputs are up-to-date.

Remarks

In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

Example

The following example uses the CreateProperty task to create the NewFile property using the combination of the values of the SourceFilename and SourceFileExtension property.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">

    <PropertyGroup>
        <SourceFilename>Module1</SourceFilename>
        <SourceFileExtension>vb</SourceFileExtension>
    </PropertyGroup>

    <Target Name="CreateProperties">

        <CreateProperty
            Value="$(SourceFilename).$(SourceFileExtension)">
            <Output
                TaskParameter="Value"
                PropertyName="NewFile" />
        </CreateProperty>

    </Target>

</Project>

After running the project, the value of the NewFile property is Module1.vb.

See Also

Concepts

MSBuild Tasks

Other Resources

MSBuild Task Reference