VCProject.AddConfiguration Method

Adds a configuration to the current project.

Namespace:  Microsoft.VisualStudio.VCProjectEngine
Assembly:  Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)

Syntax

'Declaration
Sub AddConfiguration ( _
    ConfigurationName As String _
)

void AddConfiguration(
    string ConfigurationName
)

void AddConfiguration(
    String^ ConfigurationName
)

abstract AddConfiguration : 
        ConfigurationName:string -> unit

function AddConfiguration(
    ConfigurationName : String
)

Parameters

• ConfigurationName
  Type: System.String

  Required. The configuration name.

Remarks

The Configurations property returns the configurations that are on the current project.

To have this configuration be useful, you must call the CopyTo method to copy basic settings from an existing configuration to the new configuration. Otherwise, you must set even the most rudimentary options yourself.

Examples

See How to: Compile Example Code for Project Model Extensibility for information about how to compile and run this example.

The following example uses the AddConfiguration method in the integrated development environment (IDE):

' add reference to Microsoft.VisualStudio.VCProjectEngine
Imports EnvDTE
Imports Microsoft.VisualStudio.VCProjectEngine

Public Module Module1
    Sub Test()
        Dim prj As VCProject
        Dim cfg As VCConfiguration
        prj = DTE.Solution.Projects.Item(1).Object
        prj.AddConfiguration("addedConfig")
    End Sub
End Module

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

VCProject Interface

Microsoft.VisualStudio.VCProjectEngine Namespace