Elemento de destino (MSBuild)

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

<Destino 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 destinos podem ter dependências em 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 DependsOnTargets atributo, da esquerda para a direita. Para obter mais informações, consulte Destinos.

O MSBuild depende 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 um build, mesmo que mais de um destino tenha uma dependência nele.

Se um destino for ignorado porque seu Condition atributo é avaliado false, ele ainda poderá ser executado se for invocado posteriormente no build e seu Condition atributo for avaliado true nesse momento.

Antes do MSBuild 4, Target retornava todos os itens especificados no Outputs atributo. Para fazer isso, o MSBuild teve que registrar esses itens caso as tarefas posteriores no build os solicitassem. Como não havia como indicar quais destinos tinham saídas que os chamadores precisariam, o MSBuild acumulava todos os itens de todos os Outputs s invocados Target. Isso leva a problemas de dimensionamento para builds que tinham um grande número de itens de saída.

Se o usuário especificar um Returns elemento em qualquer Target elemento em um projeto, somente aqueles Targetque têm um Returns registro de atributo registrarão esses itens.

Um Target pode conter um Outputs atributo e um Returns atributo. Outputs é usado para Inputs determinar se o destino é up-to-date. Returns, se presente, substitui o valor de Outputs determinar quais itens são retornados aos chamadores. Se Returns não estiver presente, então Outputs será disponibilizado para os chamadores, exceto no caso descrito anteriormente.

Antes do MSBuild 4, sempre que um Target várias referências incluídas 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 projeto, isso faria com que uma grande quantidade de memória fosse desperdiçada porque os itens duplicados não eram de qualquer uso. 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

• Alvos
• Referência de esquema de arquivo do projeto