We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.

SolutionBuild Interface

Represents the root of the build automation model at the solution level.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

public interface SolutionBuild

The SolutionBuild type exposes the following members.

Public propertyActiveConfigurationGets the currently active SolutionConfiguration object.
Public propertyBuildDependenciesGets a BuildDependencies collection that allows you to specify which projects depend on which other projects.
Public propertyBuildStateGets whether a build has ever been started in the current environment session, whether a build is currently in progress, or whether a build has been completed.
Public propertyDTEGets the top-level extensibility object.
Public propertyLastBuildInfoGets the number of projects that failed to build.
Public propertyParentGets the immediate parent object of a SolutionBuild object.
Public propertySolutionConfigurationsGets a collection of SolutionConfiguration object.
Public propertyStartupProjectsGets or sets the names of projects that are entry points for the application.

Public methodBuildCauses the active solution configuration to begin building.
Public methodBuildProjectBuilds the specified project and its dependencies in the context of the specified solution configuration.
Public methodCleanDeletes all compiler-generated support files for marked projects.
Public methodDebugStarts debugging the solution.
Public methodDeployCauses each project in the active solution configuration that is marked for deployment to deploy.
Public methodRunCauses the active solution configuration to execute.

The SolutionBuild object provides access to all of the solution configurations and their properties, the project build dependencies, and startup projects.

The counterpart to the SolutionBuild object at the project and item level is the ConfigurationManager object.

Sub SolutionBuildExample()
  ' Build the solution configuration.
  Dim sb As SolutionBuild = DTE.Solution.SolutionBuild
End Sub