BuildItemGroup Class

Visual Studio 2015

Represents a collection of BuildItem 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.

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

Inheritance Hierarchy

System::Object
Microsoft.Build.BuildEngine::BuildItemGroup

Syntax

C++

[DebuggerDisplayAttribute("BuildItemGroup (Count = { Count }, Condition = { Condition })")]
public ref class BuildItemGroup : IEnumerable

Constructors

	Name	Description
	BuildItemGroup()	Initializes a new instance of the BuildItemGroup 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.

Properties

	Name	Description
	Condition	Gets or sets the Condition attribute value of the item 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.
	Count	Gets a value indicating the number of BuildItem objects in the BuildItemGroup. 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.
	IsImported	Gets or sets a value indicating whether the item 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.
	Item[Int32]	Gets or sets a BuildItem object in this BuildItemGroup. 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.

Methods

	Name	Description
	AddNewItem(String^, String^)	Adds a new BuildItem with the specified Name and Include property values to the BuildItemGroup. 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.
	AddNewItem(String^, String^, Boolean)	Adds a new BuildItem with the specified Name and Include property values to the BuildItemGroup, allowing you to specify whether the Include property value is treated as a literal. 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.
	Clear()	Removes the Condition property value and all BuildItem objects from the BuildItemGroup. 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.
	Clone(Boolean)	Creates a deep or shallow copy of the BuildItemGroup. 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.
	Equals(Object^)	(Inherited from Object.)
	Finalize()	(Inherited from Object.)
	GetEnumerator()	Gets an enumerator that iterates through the BuildItemGroup. 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.
	GetHashCode()	(Inherited from Object.)
	GetType()	(Inherited from Object.)
	MemberwiseClone()	(Inherited from Object.)
	RemoveItem(BuildItem^)	Removes the specified BuildItem from the BuildItemGroup. 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.
	RemoveItemAt(Int32)	Removes the BuildItem at the specified index from the BuildItemGroup. 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.
	ToArray()	Copies the BuildItem objects in the BuildItemGroup to a new array. 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.
	ToString()	(Inherited from Object.)

Remarks

A BuildItemGroup object can represent an ItemGroup element in the project, or a virtual collection of items, containing the items created after evaluating wildcards in the Include and Exclude attributes of an Item element.

Examples

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

C++

No code example is currently available or this language may not be supported.

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.