ConfigurationManager Interface

Represents a matrix of Configuration objects, one for each combination of configuration name and platform name.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
<GuidAttribute("9043FDA1-345B-4364-900F-BC8598EB8E4F")> _
Public Interface ConfigurationManager _
    Inherits IEnumerable

[GuidAttribute("9043FDA1-345B-4364-900F-BC8598EB8E4F")]
public interface ConfigurationManager : IEnumerable

[GuidAttribute(L"9043FDA1-345B-4364-900F-BC8598EB8E4F")]
public interface class ConfigurationManager : IEnumerable

[<GuidAttribute("9043FDA1-345B-4364-900F-BC8598EB8E4F")>]
type ConfigurationManager =  
    interface
        interface IEnumerable
    end

public interface ConfigurationManager extends IEnumerable

The ConfigurationManager type exposes the following members.

Properties

	Name	Description
	ActiveConfiguration	Gets the current solution configuration that will be used if a solution build operation occurs.
	ConfigurationRowNames	Gets an array of all defined configuration names for the project or project item.
	Count	Gets a value indicating the number of objects in the collection.
	DTE	Gets the top-level extensibility object.
	Parent	Gets the immediate parent object of a ConfigurationManager object.
	PlatformNames	Gets a list of all available platforms.
	SupportedPlatforms	Gets a list of platform names that can be added to this project and which may be added to create build configurations.

Top

Methods

	Name	Description
	AddConfigurationRow	Creates a new project or project item configuration row based on the Configuration object of an existing project or project item configuration row.
	AddPlatform	Creates build settings for a new operating system platform based on the Configuration object of an existing platform.
	ConfigurationRow	Returns a collection of items representing build configurations for one configuration name, such as "Debug" or "Retail."
	DeleteConfigurationRow	Deletes a row of build configurations, such as for "Debug" or "Retail."
	DeletePlatform	Removes a column of platform configurations, such as "WinCE PalmSize."
	GetEnumerator	Returns an enumerator for items in the collection.
	Item	Returns a Configuration object of a ConfigurationManager collection.
	Platform	Returns the Configurations for this configuration.

Top

Remarks

The ConfigurationManager object is basically a matrix of project/project item configuration names and platform names. Each element of the matrix is a Configuration object. You can reference a ConfigurationManager object for a project or a project item, but some types of projects do not support project item-level build settings.

Reference this object by using EnvDTE.Project.ConfigurationManager. or EnvDTE.ProjectItem.ConfigurationManager.

Examples

Sub ConfigurationManagerExample()
   ' Before running, load a project.
   ' Set references to all necessary objects.
   Dim CM As ConfigurationManager = DTE.Solution.Projects.Item(1).ConfigurationManager
   ' List the configuration name used for the current project.
   MsgBox(CM.Item(2).ConfigurationName)
End Sub

See Also

Reference

EnvDTE Namespace