Compartir a través de


SolutionConfigurations.Add(String, String, Boolean) Method

Definition

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

A SolutionConfiguration object.

Attributes

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