ConfigurationManager Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Represents a matrix of Configuration objects, one for each combination of configuration name and platform name.
public interface class ConfigurationManager : System::Collections::IEnumerable
[System.Runtime.InteropServices.Guid("9043FDA1-345B-4364-900F-BC8598EB8E4F")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface ConfigurationManager : System.Collections.IEnumerable
[System.Runtime.InteropServices.Guid("9043FDA1-345B-4364-900F-BC8598EB8E4F")]
public interface ConfigurationManager : System.Collections.IEnumerable
[<System.Runtime.InteropServices.Guid("9043FDA1-345B-4364-900F-BC8598EB8E4F")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type ConfigurationManager = interface
interface IEnumerable
[<System.Runtime.InteropServices.Guid("9043FDA1-345B-4364-900F-BC8598EB8E4F")>]
type ConfigurationManager = interface
interface IEnumerable
Public Interface ConfigurationManager
Implements IEnumerable
- Attributes
- Implements
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
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
.
Properties
ActiveConfiguration |
Gets the current solution configuration that will be used if a solution build operation occurs. |
ConfigurationRowNames |
Gets an array of all defined configuration names for the project or project item. |
Count |
Gets a value indicating the number of objects in the collection. |
DTE |
Gets the top-level extensibility object. |
Parent |
Gets the immediate parent object of a ConfigurationManager object. |
PlatformNames |
Gets a list of all available platforms. |
SupportedPlatforms |
Gets a list of platform names that can be added to this project and which may be added to create build configurations. |
Methods
AddConfigurationRow(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. |
AddPlatform(String, String, Boolean) |
Creates build settings for a new operating system platform based on the Configuration object of an existing platform. |
ConfigurationRow(String) |
Returns a collection of items representing build configurations for one configuration name, such as "Debug" or "Retail." |
DeleteConfigurationRow(String) |
Deletes a row of build configurations, such as for "Debug" or "Retail." |
DeletePlatform(String) |
Removes a column of platform configurations, such as "WinCE PalmSize." |
GetEnumerator() |
Returns an enumerator for items in the collection. |
Item(Object, String) |
Returns a Configuration object of a ConfigurationManager collection. |
Platform(String) |
Returns the Configurations for this configuration. |