SolutionConfigurations.Add(String, String, Boolean) Method

Reference

Definition

Namespace:: EnvDTE

Assembly:: EnvDTE.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

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.

Creates a new solution configuration based on an existing one.

public:
 EnvDTE::SolutionConfiguration ^ Add(System::String ^ NewName, System::String ^ ExistingName, bool Propagate);

public:
 EnvDTE::SolutionConfiguration ^ Add(Platform::String ^ NewName, Platform::String ^ ExistingName, bool Propagate);

EnvDTE::SolutionConfiguration Add(std::wstring const & NewName, std::wstring const & ExistingName, bool Propagate);

[System.Runtime.InteropServices.DispId(3)]
public EnvDTE.SolutionConfiguration Add (string NewName, string ExistingName, bool Propagate);

[<System.Runtime.InteropServices.DispId(3)>]
abstract member Add : string * string * bool -> EnvDTE.SolutionConfiguration

Public Function Add (NewName As String, ExistingName As String, Propagate As Boolean) As SolutionConfiguration

Parameters

NewName: String

Required. The name of the new solution configuration.

ExistingName: String

Required. A SolutionConfiguration object on which to base the new solution configuration.

Propagate: Boolean

Required. True if the new solution configuration should be propagated, False if not. If Propagate is set to True, then the newly added solution configuration will be automatically added to all of the projects under that solution, as well as to the solution itself.

Returns

SolutionConfiguration

A SolutionConfiguration object.

Attributes: DispIdAttribute

Remarks

Add creates a new solution configuration based on the one named in ExistingName. The new solution configuration uses the same project configurations for the configuration and platform contexts. If ExistingName is empty, then Add creates a new solution configuration based on default values.

The default solution configuration contains all projects and marks all projects to be built. In addition, it chooses the project configurations that are active when the solution configuration is activated, subject to the following guidelines:

Any project configuration names that completely match the new solution configuration's name, including case-insensitivity, are chosen.
Failing any such matches, any project configuration name that contains the project configuration's name is chosen.
Failing that, any project configuration listed first for a project by the project is chosen. The convention is to list the Debug project configuration first if you support one with that name.

Applies to