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

Top

Methods

  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.

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