SolutionConfiguration2 Interface

Definition

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")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public 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")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type SolutionConfiguration2 = interface
    interface SolutionConfiguration
[<System.Runtime.InteropServices.Guid("1099AAA6-4169-430D-9F57-0B4C76624B3B")>]
type SolutionConfiguration2 = interface
    interface SolutionConfiguration
Public Interface SolutionConfiguration2
Implements SolutionConfiguration
Attributes
Implements

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.

Applies to