We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.

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)

public interface ConfigurationManager : IEnumerable

The ConfigurationManager type exposes the following members.

Public propertyActiveConfigurationGets the current solution configuration that will be used if a solution build operation occurs.
Public propertyConfigurationRowNamesGets an array of all defined configuration names for the project or project item.
Public propertyCountGets a value indicating the number of objects in the collection.
Public propertyDTEGets the top-level extensibility object.
Public propertyParentGets the immediate parent object of a ConfigurationManager object.
Public propertyPlatformNamesGets a list of all available platforms.
Public propertySupportedPlatformsGets a list of platform names that can be added to this project and which may be added to create build configurations.

Public methodAddConfigurationRowCreates a new project or project item configuration row based on the Configuration object of an existing project or project item configuration row.
Public methodAddPlatformCreates build settings for a new operating system platform based on the Configuration object of an existing platform.
Public methodConfigurationRowReturns a collection of items representing build configurations for one configuration name, such as "Debug" or "Retail."
Public methodDeleteConfigurationRowDeletes a row of build configurations, such as for "Debug" or "Retail."
Public methodDeletePlatformRemoves a column of platform configurations, such as "WinCE PalmSize."
Public methodGetEnumeratorReturns an enumerator for items in the collection.
Public methodItemReturns a Configuration object of a ConfigurationManager collection.
Public methodPlatformReturns the Configurations for this configuration.

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.

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.
End Sub