Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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

The ConfigurationManager type exposes the following members.

  NameDescription
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.
Top
  NameDescription
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.
Top

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
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.