SolutionConfiguration2 Interface

Definition

Namespace:

EnvDTE80

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.12.40391

Represents information about a particular way to build the solution.

public interface class SolutionConfiguration2 : EnvDTE::SolutionConfiguration

public interface class SolutionConfiguration2 : EnvDTE::SolutionConfiguration

__interface SolutionConfiguration2 : EnvDTE::SolutionConfiguration

[System.Runtime.InteropServices.Guid("1099AAA6-4169-430D-9F57-0B4C76624B3B")]
public interface SolutionConfiguration2 : EnvDTE.SolutionConfiguration

[<System.Runtime.InteropServices.Guid("1099AAA6-4169-430D-9F57-0B4C76624B3B")>]
type SolutionConfiguration2 = interface
    interface SolutionConfiguration

Public Interface SolutionConfiguration2
Implements SolutionConfiguration

Attributes

GuidAttribute

Implements

SolutionConfiguration

Examples

This example displays each solution configuration item's name and sets the first item's configuration name to "release". Open a project in the Visual Studio integrated development environment (IDE) before running this example.

Imports EnvDTE  
Imports EnvDTE80  
Sub SolutionConfigurationExample(ByVal dte As DTE2)  
    Try  
        Dim builder As SolutionBuild = _  
        _applicationObject.Solution.SolutionBuild  
        Dim config As SolutionConfiguration2  
        config = CType(builder.ActiveConfiguration _  
        , SolutionConfiguration2)  
        Dim i As Integer  
        Dim aStr As String  
        aStr = ""  
        For i = 1 To config.SolutionContexts.Count  
        aStr = aStr & "The configuration item number " & i.ToString() _  
            & "'s name is: " & config.SolutionContexts. _  
            Item(i).ConfigurationName.ToString() & vbCr  
        Next  
        MsgBox("The configuration names per item are:" & vbCr & aStr)  
        MsgBox("Change the configuration of item 1 to 'Release'...")  
        config.SolutionContexts.Item(1).ConfigurationName = "Release"  
        MsgBox("The solution configuration name for  _  
        configuration item 1 is now: " &  _  
        config.SolutionContexts.Item(1).ConfigurationName.ToString())  
    Catch ex As System.Exception  
        MsgBox(ex.ToString)  
    End Try  

End Sub  

using EnvDTE;  
using EnvDTE80;  
using System.Windows.Forms;  
public void SolutionConfigurationExample(DTE2 dte)  
{  
    try  
    {  
        SolutionBuild builder =  
 _applicationObject.Solution.SolutionBuild;  
        SolutionConfiguration2 config;  
        config = (SolutionConfiguration2)builder.ActiveConfiguration;  
        int i;  
        String aStr = null;  
        for (i = 1; i <= config.SolutionContexts.Count;i++ )  
        {  
        aStr = aStr + "The configuration item number " + i.ToString()   
+ "'s name is: " +  
 config.SolutionContexts.Item(i).ConfigurationName.ToString() + "\n";  
        }  
        MessageBox.Show("The configuration names per item are:" + "\n"  
 + aStr);  
        MessageBox.Show("Change the configuration of item   
1 to 'Release'...");  
        config.SolutionContexts.Item(1).ConfigurationName = "Release";  
        MessageBox.Show("The solution configuration name   
for configuration item 1 is now: " +   
config.SolutionContexts.Item(1).ConfigurationName.ToString());  
    }  
    catch(SystemException ex)  
    {  
        MessageBox.Show(ex.ToString());  
    }  
}  

Remarks

For each project SolutionConfiguration also represents which project configuration and platform provide context for the build operation and design-time features in the environment, such as statement completion in the editor.

Properties

Collection	Gets the SolutionConfigurations collection containing the SolutionConfiguration object supporting this property.
DTE	Gets the top-level extensibility object.
Name	Gets the name of the object.
PlatformName	Gets the target platform CPU for configuration.
SolutionContexts	Gets a collection of SolutionContext objects.

Methods

Activate()	Moves the focus to the current item.
Delete()	Removes the SolutionConfiguration object from the collection.