Método SolutionBuild2.BuildProject

Artigo
05/17/2015

Constrói o projeto especificado e suas dependências no contexto da configuração de solução especificada.

Namespace: EnvDTE80
Assembly: EnvDTE80 (em EnvDTE80.dll)

Sintaxe

'Declaração
Sub BuildProject ( _
    SolutionConfiguration As String, _
    ProjectUniqueName As String, _
    WaitForBuildToFinish As Boolean _
)

void BuildProject(
    string SolutionConfiguration,
    string ProjectUniqueName,
    bool WaitForBuildToFinish
)

void BuildProject(
    String^ SolutionConfiguration, 
    String^ ProjectUniqueName, 
    bool WaitForBuildToFinish
)

abstract BuildProject : 
        SolutionConfiguration:string * 
        ProjectUniqueName:string * 
        WaitForBuildToFinish:bool -> unit

function BuildProject(
    SolutionConfiguration : String, 
    ProjectUniqueName : String, 
    WaitForBuildToFinish : boolean
)

Parâmetros

SolutionConfiguration
Tipo: String

Obrigatório. O nome da nova configuração de solução que fornece o contexto no qual construir o projeto.

ProjectUniqueName
Tipo: String

Obrigatório. O projeto seja compilado.

WaitForBuildToFinish
Tipo: Boolean

Opcional. Determina se deve aguardar a conclusão da compilação. Se true, e em seguida, ele espera, caso contrário, ele não espera.

Comentários

BuildProjectretorna imediatamente. Para determinar quando uma operação de compilação da solução for concluída, você deve verificar a OnBuildDone evento.

BuildProjectnão afeta a interface do usuário (UI) em termos de alterar a configuração da solução ativa ou o projeto selecionado. Se você quiser construir o projeto em relação à configuração de solução ativa, use DTE.SolutionBuild.ActiveConfiguration.Name.

BuildProjectafetam a interface do usuário com base na DTE.SuppressUI sinalizar que a barra de Status pisca e o Janela de saída e Lista de tarefas são sempre atualizadas.

BuildProjectconstrói o projeto especificado e todas as suas dependências que são verificadas para ser construído na configuração de solução especificada.

Exemplos

Este exemplo cria um projeto no modo de depuração. Abrir um projeto na Visual Studio o ambiente de desenvolvimento integrado (IDE) antes de executar este suplemento.

Para obter mais informações sobre como executar este exemplo como um add-in, consulte Como compilar e executar os exemplos de código do modelo de objeto Automation.

Imports EnvDTE
Imports EnvDTE80
Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    SolutionBuildProjectExample(_applicationObject)
End Sub
Sub SolutionBuildProjectExample(ByVal dte As DTE2)
    ' Open a solution in Visual Studio before running this example.
    Try
        Dim soln As Solution2 = CType(_applicationObject.Solution, _
        Solution2)
        Dim sb As SolutionBuild2
        Dim bld As BuildDependencies
        Dim p1 As Project = soln.Projects.Item(1)
        sb = CType(soln.SolutionBuild, SolutionBuild2)
        bld = sb.BuildDependencies
        MsgBox("The project " & bld.Item(1).Project.Name & " has "  _
        & bld.Count.ToString() & " build dependencies.")
        MsgBox("Building the project in debug mode...")
        sb.BuildProject("Debug", p1.FullName, True)
    Catch ex As System.Exception
        MsgBox(ex.ToString)
    End Try
End Sub

using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
public void OnConnection(object application,
 ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    SolutionBuildProjectExample(_applicationObject);
}
public void SolutionBuildProjectExample(DTE2 dte)
{
    try
    {
        Solution2 soln = (Solution2)_applicationObject.Solution;
        SolutionBuild2 sb;
        BuildDependencies bld;
        Project p1 = soln.Projects.Item(1);
        // Open a solution in Visual Studio before 
        // running this example.
        sb = (SolutionBuild2)soln.SolutionBuild;
        bld = sb.BuildDependencies;
        MessageBox.Show("The project " + bld.Item(1).Project.Name 
+ " has " + bld.Count.ToString() + " build dependencies.");
        MessageBox.Show("Building the project in debug mode...");
        sb.BuildProject("Debug", p1.FullName,true);
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

SolutionBuild2 Interface

Namespace EnvDTE80

Compartilhar via