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)


<GuidAttribute("9043FDA1-345B-4364-900F-BC8598EB8E4F")> _
Public Interface ConfigurationManager _
    Inherits IEnumerable
public interface ConfigurationManager : IEnumerable
public interface class ConfigurationManager : IEnumerable
type ConfigurationManager =  
        interface IEnumerable
public interface ConfigurationManager extends IEnumerable

The ConfigurationManager type exposes the following members.


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



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

See Also


EnvDTE Namespace