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 class ConfigurationManager : IEnumerable

NameDescription
System_CAPS_pubpropertyActiveConfiguration

Gets the current solution configuration that will be used if a solution build operation occurs.

System_CAPS_pubpropertyConfigurationRowNames

Gets an array of all defined configuration names for the project or project item.

System_CAPS_pubpropertyCount

Gets a value indicating the number of objects in the collection.

System_CAPS_pubpropertyDTE

Gets the top-level extensibility object.

System_CAPS_pubpropertyParent

Gets the immediate parent object of a ConfigurationManager object.

System_CAPS_pubpropertyPlatformNames

Gets a list of all available platforms.

System_CAPS_pubpropertySupportedPlatforms

Gets a list of platform names that can be added to this project and which may be added to create build configurations.

NameDescription
System_CAPS_pubmethodAddConfigurationRow(String^, String^, Boolean)

Creates a new project or project item configuration row based on the Configuration object of an existing project or project item configuration row.

System_CAPS_pubmethodAddPlatform(String^, String^, Boolean)

Creates build settings for a new operating system platform based on the Configuration object of an existing platform.

System_CAPS_pubmethodConfigurationRow(String^)

Returns a collection of items representing build configurations for one configuration name, such as "Debug" or "Retail."

System_CAPS_pubmethodDeleteConfigurationRow(String^)

Deletes a row of build configurations, such as for "Debug" or "Retail."

System_CAPS_pubmethodDeletePlatform(String^)

Removes a column of platform configurations, such as "WinCE PalmSize."

System_CAPS_pubmethodGetEnumerator()

Returns an enumerator for items in the collection.

System_CAPS_pubmethodItem(Object^, String^)

Returns a Configuration object of a ConfigurationManager collection.

System_CAPS_pubmethodPlatform(String^)

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.
   MsgBox(CM.Item(2).ConfigurationName)
End Sub
Return to top
Show: