Target – element (MSBuild)Target element (MSBuild)

• 06/13/2019
• 4 min ke čtení
• • g
  • o

Obsahuje sadu úloh, které má nástroj MSBuild spustit sekvenčně.Contains a set of tasks for MSBuild to execute sequentially.

<Project> <Target><Project> <Target>

SyntaxSyntax

<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>

Atributy a elementyAttributes and elements

Následující části popisují atributy, podřízené prvky a nadřazené prvky.The following sections describe attributes, child elements, and parent elements.

AtributyAttributes

Podřízené prvkyChild elements

Nadřazené prvkyParent elements

PoznámkyRemarks

První cíl, který má být spuštěn, je určen v době běhu.The first target to execute is specified at run time. Cíle můžou mít závislosti na jiných cílech.Targets can have dependencies on other targets. Například cíl pro nasazení závisí na cíli pro kompilaci.For example, a target for deployment depends on a target for compilation. Modul MSBuild spouští závislosti v pořadí, ve kterém jsou uvedeny v DependsOnTargets atributu zleva doprava.The MSBuild engine executes dependencies in the order in which they appear in the DependsOnTargets attribute, from left to right. Další informace najdete v tématu cíle.For more information, see Targets.

MSBuild je závislý na pořadí importu a poslední definice cíle s konkrétním Name atributem je použitá definice.MSBuild is import-order dependent, and the last definition of a target with a specific Name attribute is the definition used.

Cíl se spustí pouze jednou během sestavení, i když na něm závisí více než jeden cíl.A target is only executed once during a build, even if more than one target has a dependency on it.

Pokud je cíl vynechán, protože se jeho Condition atribut vyhodnocuje false , může být stále proveden, pokud je vyvolán později v sestavení a jeho atribut je Condition true v daném čase vyhodnocen jako.If a target is skipped because its Condition attribute evaluates to false, it can still be executed if it is invoked later in the build and its Condition attribute evaluates to true at that time.

Před MSBuild 4 Target vrátily všechny položky, které byly zadány v Outputs atributu.Before MSBuild 4, Target returned any items that were specified in the Outputs attribute. Nástroj MSBuild musel tyto položky zaznamenat v případě, že je požaduje, později v sestavení.To do this, MSBuild had to record these items in case tasks later in the build requested them. Vzhledem k tomu, že neexistuje žádný způsob, jak určit, které cíle obsahovaly výstupy, které by volající vyžadovaly, nástroj MSBuild shromáždil všechny položky ze všech Outputs vyvolaných Target s.Because there was no way to indicate which targets had outputs that callers would require, MSBuild accumulated all items from all Outputs on all invoked Targets. To vede k škálování problémů pro sestavení, která měla velký počet výstupních položek.This lead to scaling problems for builds that had a large number of output items.

Pokud uživatel určí Returns u libovolného Target elementu v projektu, pak pouze ty Target , které mají Returns atribut, tyto položky se zaznamenají.If the user specifies a Returns on any Target element in a project, then only those Targets that have a Returns attribute record those items.

TargetMůže obsahovat Outputs atribut i Returns atribut.A Target may contain both an Outputs attribute and a Returns attribute. Outputs se používá s Inputs k určení, zda je cíl v aktuálním stavu.Outputs is used with Inputs to determine whether the target is up-to-date. Returns, pokud je k dispozici, Přepisuje hodnotu Outputs k určení, které položky jsou vraceny volajícím.Returns, if present, overrides the value of Outputs to determine which items are returned to callers. Pokud není k Returns Outputs dispozici, bude zpřístupněna volajícím s výjimkou výše popsaného případu.If Returns is not present, then Outputs will be made available to callers except in the case described earlier.

Před tím, než nástroj MSBuild 4 pokaždé, když jsou Target zahrnuté více odkazů na stejnou položku Outputs , budou tyto duplicitní položky zaznamenávány.Before MSBuild 4, any time that a Target included multiple references to the same item in its Outputs, those duplicate items would be recorded. Ve velmi rozsáhlých sestaveních, která měla velký počet výstupů a mnoho vzájemně závislých projektů, by to znamenalo neplýtvání velkého množství paměti, protože duplicitní položky nebyly žádného použití.In very large builds that had a large number of outputs and many project interdependencies, this would cause a large amount of memory to be wasted because the duplicate items were not of any use. Pokud KeepDuplicateOutputs je atribut nastaven na true , jsou tyto duplicity zaznamenávány.When the KeepDuplicateOutputs attribute is set to true, these duplicates are recorded.

PříkladExample

Následující příklad kódu ukazuje Target prvek, který Csc úlohu spouští.The following code example shows a Target element that executes the Csc task.

<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>

Viz takéSee also

• TargetsTargets
• Referenční dokumentace schématu souboru projektuProject file schema reference