Share via


BuildPropertyGroup Class

Represents a collection of BuildProperty objects.

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.

Inheritance Hierarchy

System.Object
  Microsoft.Build.BuildEngine.BuildPropertyGroup

Namespace:  Microsoft.Build.BuildEngine
Assembly:  Microsoft.Build.Engine (in Microsoft.Build.Engine.dll)

Syntax

'Declaration
Public Class BuildPropertyGroup _
    Implements IEnumerable
public class BuildPropertyGroup : IEnumerable
public ref class BuildPropertyGroup : IEnumerable
type BuildPropertyGroup =  
    class 
        interface IEnumerable 
    end
public class BuildPropertyGroup implements IEnumerable

The BuildPropertyGroup type exposes the following members.

Constructors

  Name Description
Public method BuildPropertyGroup() Initializes a new instance of the BuildPropertyGroup class.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.
Public method BuildPropertyGroup(Project) Initializes a new PropertyGroup element in the specified project.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.

Top

Properties

  Name Description
Public property Condition Gets or sets the Condition attribute value of the property group.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.
Public property Count Gets a value indicating the number of BuildProperty objects in the BuildPropertyGroup.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.
Public property IsImported Gets or sets a value indicating whether the property group was imported into the project.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.
Public property Item Gets or sets a BuildProperty object in this BuildPropertyGroup.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.

Top

Methods

  Name Description
Public method AddNewProperty(String, String) Adds a new BuildProperty with the specified Name and Value to the BuildPropertyGroup.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.
Public method AddNewProperty(String, String, Boolean) Adds a new BuildProperty with the specified Name and Value to the BuildPropertyGroup.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.
Public method Clear Removes the Condition property value and all BuildProperty objects from the BuildPropertyGroup.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.
Public method Clone Creates a deep or shallow copy of the BuildPropertyGroup.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.
Public method Equals (Inherited from Object.)
Protected method Finalize (Inherited from Object.)
Public method GetEnumerator Gets an enumerator that iterates through the BuildPropertyGroup.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.
Public method GetHashCode (Inherited from Object.)
Public method GetType (Inherited from Object.)
Protected method MemberwiseClone (Inherited from Object.)
Public method RemoveProperty(String) Removes the BuildProperty with the specified Name from the BuildPropertyGroup.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.
Public method RemoveProperty(BuildProperty) Removes the specified BuildProperty from the BuildPropertyGroup.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.
Public method SetImportedPropertyGroupCondition Sets the condition for imported property groups. Changes are not persisted.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.
Public method SetProperty(String, String) Sets the Value of the BuildProperty with the specified Name.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.
Public method SetProperty(String, String, Boolean) Sets the Value of the BuildProperty with the specified Name.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.
Public method ToString (Inherited from Object.)

Top

Remarks

A BuildPropertyGroup object can represent a PropertyGroup element in the project, or a virtual collection of properties, such as global properties or environment variable properties.

Examples

The following example creates a Project object and uses the LoadXml method to add content to the project. The BuildProperty, BuildPropertyGroup, and BuildPropertyGroupCollection classes are used to add, remove, and change items in the project.

Module Module1

    ''' <summary> 
    ''' This code demonstrates the use of the following methods: 
    '''     Engine constructor 
    '''     Project constructor 
    '''     Project.LoadFromXml 
    '''     Project.Xml 
    '''     BuildPropertyGroupCollection.GetEnumerator 
    '''     BuildPropertyGroup.GetEnumerator 
    '''     BuildProperty.Name (get) 
    '''     BuildProperty.Value (set) 
    '''     BuildPropertyGroup.RemoveProperty 
    '''     BuildPropertyGroup.AddNewProperty 
    ''' </summary> 
    ''' <remarks></remarks> 
    Sub Main()

        ' Create a new Engine object. 
        Dim engine As New Engine(Environment.CurrentDirectory)

        ' Create a new Project object. 
        Dim project As New Project(engine)

        ' Load the project with the following XML, which contains 
        ' two PropertyGroups.
        project.LoadXml( _
            "<Project xmlns='https://schemas.microsoft.com/developer/msbuild/2003'>" & _
                "<PropertyGroup>" & _
                    "<Optimize>true</Optimize>" & _
                    "<WarningLevel>4</WarningLevel>" & _
                "</PropertyGroup>" & _
                "<PropertyGroup>" & _
                    "<OutputPath>bin\debug\</OutputPath>" & _
                    "<RemoveThisPropertyPlease>1</RemoveThisPropertyPlease>" & _
                "</PropertyGroup>" & _
            "</Project>")

        ' Iterate through each PropertyGroup in the Project.  There are two. 
        For Each pg As BuildPropertyGroup In project.PropertyGroups

            Dim propertyToRemove As BuildProperty
            propertyToRemove = Nothing 

            ' Iterate through each Property in the PropertyGroup. 
            For Each buildProperty As BuildProperty In pg

                ' If the property's name is "RemoveThisPropertyPlease", then 
                ' store a reference to this property in a local variable, 
                ' so we can remove it later. 
                If buildProperty.Name = "RemoveThisPropertyPlease" Then
                    propertyToRemove = buildProperty
                End If 

                ' If the property's name is "OutputPath", change its value 
                ' from "bin\debug\" to "bin\release\". 
                If buildProperty.Name = "OutputPath" Then
                    buildProperty.Value = "bin\release\" 
                End If 

            Next 

            ' Remove the property named "RemoveThisPropertyPlease" from the 
            ' PropertyGroup 
            If Not propertyToRemove Is Nothing Then
                pg.RemoveProperty(propertyToRemove)
            End If 

            ' For each PropertyGroup that we found, add to the end of it 
            ' a new property called "MyNewProperty".
            pg.AddNewProperty("MyNewProperty", "MyNewValue")

        Next 

        '  The project now looks like this: 
        '  
        '      <?xml version="1.0" encoding="utf-16"?> 
        '      <Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003"> 
        '        <PropertyGroup> 
        '          <Optimize>true</Optimize> 
        '          <WarningLevel>4</WarningLevel> 
        '          <MyNewProperty>MyNewValue</MyNewProperty> 
        '        </PropertyGroup> 
        '        <PropertyGroup> 
        '          <OutputPath>bin\release</OutputPath> 
        '          <MyNewProperty>MyNewValue</MyNewProperty> 
        '        </PropertyGroup> 
        '      </Project>
        Console.WriteLine(project.Xml)

    End Sub 

End Module
using System;
using System.Collections.Generic;
using System.Text;

using Microsoft.Build.BuildEngine;

namespace AddNewProperty
{
    class Program
    {
        /// <summary> 
        /// This code demonstrates the use of the following methods: 
        ///     Engine constructor 
        ///     Project constructor 
        ///     Project.LoadFromXml 
        ///     Project.Xml 
        ///     BuildPropertyGroupCollection.GetEnumerator 
        ///     BuildPropertyGroup.GetEnumerator 
        ///     BuildProperty.Name (get) 
        ///     BuildProperty.Value (set) 
        ///     BuildPropertyGroup.RemoveProperty 
        ///     BuildPropertyGroup.AddNewProperty 
        /// </summary> 
        static void Main()
        {
            // Create a new Engine object.
            Engine engine = new Engine(Environment.CurrentDirectory);

            // Create a new Project object.
            Project project = new Project(engine);

            // Load the project with the following XML, which contains 
            // two PropertyGroups.
            project.LoadXml(@"
                <Project xmlns='https://schemas.microsoft.com/developer/msbuild/2003'>

                    <PropertyGroup>
                        <Optimize>true</Optimize>
                        <WarningLevel>4</WarningLevel>
                    </PropertyGroup>

                    <PropertyGroup>
                        <OutputPath>bin\debug\</OutputPath>
                        <RemoveThisPropertyPlease>1</RemoveThisPropertyPlease>
                    </PropertyGroup>

                </Project>
                ");

            // Iterate through each PropertyGroup in the Project.  There are two. 
            foreach (BuildPropertyGroup pg in project.PropertyGroups)
            {
                BuildProperty propertyToRemove = null;

                // Iterate through each Property in the PropertyGroup. 
                foreach (BuildProperty property in pg)
                {
                    // If the property's name is "RemoveThisPropertyPlease", then
                    // store a reference to this property in a local variable, 
                    // so we can remove it later. 
                    if (property.Name == "RemoveThisPropertyPlease")
                    {
                        propertyToRemove = property;
                    }

                    // If the property's name is "OutputPath", change its value 
                    // from "bin\debug\" to "bin\release\".
                    if (property.Name == "OutputPath")
                    {
                        property.Value = @"bin\release\";
                    }
                }

                // Remove the property named "RemoveThisPropertyPlease" from the
                // PropertyGroup 
                if (propertyToRemove != null)
                {
                    pg.RemoveProperty(propertyToRemove);
                }

                // For each PropertyGroup that we found, add to the end of it 
                // a new property called "MyNewProperty".
                pg.AddNewProperty("MyNewProperty", "MyNewValue");
            }

            // The project now looks like this: 
            // 
            //     <?xml version="1.0" encoding="utf-16"?>
            //     <Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
            //       <PropertyGroup> 
            //         <Optimize>true</Optimize> 
            //         <WarningLevel>4</WarningLevel> 
            //         <MyNewProperty>MyNewValue</MyNewProperty> 
            //       </PropertyGroup> 
            //       <PropertyGroup> 
            //         <OutputPath>bin\release</OutputPath> 
            //         <MyNewProperty>MyNewValue</MyNewProperty> 
            //       </PropertyGroup> 
            //     </Project>
            Console.WriteLine(project.Xml);
        }
    }
}

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.Build.BuildEngine Namespace