Elemento de destino (MSBuild)

Contém um conjunto de tarefas para MSBuild para executar em seqüência.

<Target Name="Target Name"
        DependsOnTargets="DependentTarget"
        Inputs="Inputs"
        Outputs="Outputs"
        Condition="'String A' == 'String B'">
    <Task>... </Task>
    <OnError... />
</Target>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Atributo

Descrição

Name

Atributo obrigatório.

O nome do destino.

DependsOnTargets

Atributo opcional.

Os destinos que devem ser executados antes deste podem executar ou análise de dependência de nível superior pode ocorrer. Vários destinos são separados por ponto-e-vírgula.

Inputs

Atributo opcional.

As entradas de item para este destino. Itens dentro desse atributo são usados sistema autônomo sistema autônomo entradas na análise de dependência de nível superior.

Outputs

Atributo opcional.

As saídas deste destino esperadas. Você pode aplicar transformações a entrada itens para gerar os itens de saída. Para obter mais informações sobre transformações, consulte Transformações do MSBuild.

Condition

Atributo opcional.

Condição a ser avaliada. Se a condição for avaliada como false, o destino não irá executar o corpo do destino ou qualquer destino definido no DependsOnTargets atributo. Para obter mais informações sobre as condições, consulte Condições do MSBuild.

Elementos filho

Elemento

Descrição

Tarefa

Cria e executa uma instância de um MSBuild tarefa. Pode haver zero ou mais tarefas em um destino.

OnError

Faz com que um ou mais destinos a ser executado se o ContinueOnError o atributo é false para uma tarefa com falha. Pode haver zero ou mais OnError elementos em um destino. If OnError elementos estão presentes, elas devem ser os elementos no últimos a Target elemento.

Elementos pai

Elemento

Descrição

Project

Elemento raiz exigido de um MSBuild arquivo de projeto.

Comentários

O primeiro destino para executar será especificado no tempo de execução. Destinos podem ter dependências em outros destinos. Por exemplo, um destino para implantação depende de destino de compilação. The MSBuild mecanismo executa dependências na ordem que aparecem na DependsOnTargets atributo da esquerda para a direita. Para obter mais informações, consulte Destinos do MSBuild.

Um destino é executado apenas uma vez durante uma compilação, mesmo se mais de um destino tem uma dependência nele.

Se um destino é ignorado porque o Condition atributo é avaliada como false, ele ainda pode ser executado se for chamado posteriormente na compilação e seu Condition atributo é avaliada como true Nesse momento.

Exemplo

O exemplo de código a seguir mostra um Target elemento que executa o Csc tarefa.

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

Consulte também

Conceitos

Destinos do MSBuild

Referência de esquema de arquivo de projeto MSBuild