Elemento de destino (MSBuild)

Contém um conjunto de tarefas para o MSBuild executar sequencialmente.

<Alvo do Projeto><>

Sintaxe

<Target Name="Target Name"
        Inputs="Inputs"
        Outputs="Outputs"
        Returns="Returns"
        KeepDuplicateOutputs="true/false"
        BeforeTargets="Targets"
        AfterTargets="Targets"
        DependsOnTargets="DependentTarget"
        Condition="'String A' == 'String B'"
        Label="Label">
    <Task>... </Task>
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <OnError... />
</Target>

Atributos e elementos

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

Attributes

Elementos filho

Elementos pai

Observações

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

MSBuild é dependente da ordem de importação, e a última definição de um destino com um atributo específico Name é a definição usada.

Um destino só é executado uma vez durante uma compilação, mesmo que mais de um destino dependa dele.

Se um alvo for ignorado porque o seu Condition atributo avalia para false, ainda pode ser executado se for invocado mais tarde na build e o seu Condition atributo for avaliado para true nesse momento.

Antes do MSBuild 4, Target retornava todos os Outputs itens especificados no atributo. Para fazer isso, o MSBuild teve que registrar esses itens caso tarefas posteriores na compilação os solicitassem. Como não havia como indicar quais destinos tinham saídas que os chamadores exigiriam, o MSBuild acumulou todos os itens de todos Outputs em todos os s invocados Target. Isto levou a problemas de escalabilidade para builds que tinham um grande número de itens de saída.

Se o usuário especificar um Returns em qualquer Target elemento em um projeto, somente os Targets que têm um Returns atributo registrarão esses itens.

A Target pode conter um Outputs atributo e um Returns atributo. Outputs é usado com Inputs para determinar se o destino é up-to-date. Returns, se presente, substitui o valor de para determinar quais itens são retornados Outputs aos chamadores. Se Returns não estiver presente, estará Outputs disponível para os ouvintes, exceto no caso descrito anteriormente.

O resultado disponibilizado aos chamadores através Outputs de ou Returns é captado imediatamente após a conclusão do alvo. Inspecionar o estado da mesma expressão de item mais tarde pode devolver resultados diferentes, por exemplo, se outro alvo enganchar o alvo com AfterTargets e modificar a lista de itens devolvidos (depois de o alvo estar concluído, mas antes de devolver o controlo ao chamador do alvo).

Antes do MSBuild 4, sempre que um Target incluísse várias referências ao mesmo item em seu Outputs, esses itens duplicados seriam registrados. Em builds muito grandes que tinham um grande número de saídas e muitas interdependências de projetos, isto causava o desperdício de uma grande quantidade de memória porque os itens duplicados não eram úteis. Quando o KeepDuplicateOutputs atributo é definido como true, essas duplicatas são registradas.

Example

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

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

Consulte também

• Objetivos
• Referência de esquema de arquivo de projeto