Property Element (MSBuild)

Note

This article applies to Visual Studio 2015. If you're looking for Visual Studio 2017 documentation, use the version selector at the top left. We recommend upgrading to Visual Studio 2017. Download it here.

Contains a user defined property name and value. Every property used in an MSBuild project must be specified as a child of a PropertyGroup element.

<Project>
<PropertyGroup>

Syntax

<Property Condition="'String A' == 'String B'">  
    Property Value  
</Property>  

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
Condition Optional attribute.

Condition to be evaluated. For more information, see Conditions.

Child Elements

None.

Parent Elements

Element Description
PropertyGroup Grouping element for properties.

Text Value

A text value is optional.

This text specifies the property value and may contain XML.

Remarks

Property names are limited to ASCII chars only. Property values are referenced in the project by placing the property name between "$(" and ")". For example, $(builddir)\classes would resolve to "build\classes", if the builddir property had the value build. For more information on properties, see MSBuild Properties.

Example

The following code sets the Optimization property to false and the DefaultVersion property to 1.0 if the Version property is empty.

<PropertyGroup>  
    <Optimization>false</Optimization>  
    <DefaultVersion Condition="'$(Version)' == ''" >1.0</DefaultVersion>  
</PropertyGroup>  

See Also

MSBuild Properties
Project File Schema Reference