Metadata položek v dávkování úloh

  • Článek

Nástroj MSBuild má možnost rozdělit seznamy položek do různých kategorií nebo dávek na základě metadat položek a spustit úlohu jednou s každou dávkou. Může být matoucí pochopit, které položky se předávají s jakou dávkou. Toto téma se věnuje následujícím běžným scénářům, které zahrnují dávkování.

  • Rozdělení seznamu položek na dávky

  • Rozdělení několika seznamů položek do dávek

  • Dávkování jedné položky najednou

  • Filtrování seznamů položek

Další informace o dávkování pomocí nástroje MSBuild naleznete v tématu Dávkování.

Rozdělení seznamu položek do dávek

Dávkování umožňuje rozdělit seznam položek do různých dávek na základě metadat položek a předat jednotlivé dávky do úkolu samostatně. To je užitečné pro vytváření satelitních sestavení.

Následující příklad ukazuje, jak rozdělit seznam položek na dávky na základě metadat položek. Seznam ExampColl položek je rozdělen do tří dávek na Number základě metadat položky. Přítomnost atributu %(ExampColl.Number)Text oznámí nástroji MSBuild, že má být provedeno dávkování. Seznam ExampColl položek je rozdělený do tří dávek na Number základě metadat a každá dávka se předá do úkolu samostatně.

<Project
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <ExampColl Include="Item1">
            <Number>1</Number>
        </ExampColl>
        <ExampColl Include="Item2">
            <Number>2</Number>
        </ExampColl>
        <ExampColl Include="Item3">
            <Number>3</Number>
        </ExampColl>
        <ExampColl Include="Item4">
            <Number>1</Number>
        </ExampColl>
        <ExampColl Include="Item5">
            <Number>2</Number>
        </ExampColl>
        <ExampColl Include="Item6">
            <Number>3</Number>
        </ExampColl>
    </ItemGroup>

    <Target Name="ShowMessage">
        <Message
            Text = "Number: %(ExampColl.Number) -- Items in ExampColl: @(ExampColl)"/>
    </Target>

</Project>

Úloha Zpráva zobrazí následující informace:

Number: 1 -- Items in ExampColl: Item1;Item4

Number: 2 -- Items in ExampColl: Item2;Item5

Number: 3 -- Items in ExampColl: Item3;Item6

Rozdělení několika seznamů položek do dávek

Nástroj MSBuild může rozdělit více seznamů položek na dávky na základě stejných metadat. To usnadňuje rozdělení různých seznamů položek do dávek pro sestavení více sestavení. Můžete mít například seznam položek souborů .cs rozdělený do dávky aplikace a dávky sestavení a seznam položek souborů prostředků rozdělený do dávky aplikace a dávky sestavení. Pomocí dávkování pak můžete tyto seznamy položek předat do jednoho úkolu a sestavit aplikaci i sestavení.

Poznámka:

Pokud seznam položek předaný do úkolu neobsahuje žádné položky s odkazovanými metadaty, každá položka v tomto seznamu položek se předá do každé dávky.

Následující příklad ukazuje, jak rozdělit více seznamů položek do dávek na základě metadat položek. ExampColl2 Seznamy ExampColl položek jsou rozdělené do tří dávek na Number základě metadat položek. Přítomnost atributu %(Number)Text oznámí nástroji MSBuild, že má být provedeno dávkování. ExampColl2 Seznamy ExampColl položek jsou rozděleny do tří dávek na Number základě metadat a každá dávka se předává do úkolu samostatně.

<Project
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>

        <ExampColl Include="Item1">
            <Number>1</Number>
        </ExampColl>
        <ExampColl Include="Item2">
            <Number>2</Number>
        </ExampColl>
        <ExampColl Include="Item3">
            <Number>3</Number>
        </ExampColl>

        <ExampColl2 Include="Item4">
            <Number>1</Number>
        </ExampColl2>
        <ExampColl2 Include="Item5">
            <Number>2</Number>
        </ExampColl2>
        <ExampColl2 Include="Item6">
            <Number>3</Number>
        </ExampColl2>

    </ItemGroup>

    <Target Name="ShowMessage">
        <Message
            Text = "Number: %(Number) -- Items in ExampColl: @(ExampColl) ExampColl2: @(ExampColl2)"/>
    </Target>

</Project>

Úloha Zpráva zobrazí následující informace:

Number: 1 -- Items in ExampColl: Item1 ExampColl2: Item4

Number: 2 -- Items in ExampColl: Item2 ExampColl2: Item5

Number: 3 -- Items in ExampColl: Item3 ExampColl2: Item6

Batch one item at a time

Dávkování lze provést také u známých metadat položek, která jsou přiřazena ke každé položce při vytváření. To zaručuje, že každá položka v kolekci bude mít určitá metadata, která se mají použít pro dávkování. Hodnota Identity metadat je užitečná pro rozdělení každé položky v seznamu položek do samostatné dávky. Úplný seznam známých metadat položek najdete v tématu Metadata známých položek.

Následující příklad ukazuje, jak dávkot každou položku v seznamu položek po jednom. Seznam ExampColl položek je rozdělený do šesti dávek, přičemž každá dávka obsahuje jednu položku seznamu položek. Přítomnost atributu %(Identity)Text oznámí nástroji MSBuild, že má být provedeno dávkování.

<Project
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>

        <ExampColl Include="Item1"/>
        <ExampColl Include="Item2"/>
        <ExampColl Include="Item3"/>
        <ExampColl Include="Item4"/>
        <ExampColl Include="Item5"/>
        <ExampColl Include="Item6"/>

    </ItemGroup>

    <Target Name="ShowMessage">
        <Message
            Text = "Identity: '%(Identity)' -- Items in ExampColl: @(ExampColl)"/>
    </Target>

</Project>

Úloha Zpráva zobrazí následující informace:

Identity: 'Item1' -- Items in ExampColl: Item1
Identity: 'Item2' -- Items in ExampColl: Item2
Identity: 'Item3' -- Items in ExampColl: Item3
Identity: 'Item4' -- Items in ExampColl: Item4
Identity: 'Item5' -- Items in ExampColl: Item5
Identity: 'Item6' -- Items in ExampColl: Item6

Není však zaručeno, Identity že je jedinečná; její hodnota je vyhodnocená konečná hodnota atributu Include . Proto pokud se některé Include atributy používají vícekrát, jsou dávkové dohromady. Jak ukazuje následující příklad, tato technika vyžaduje Include , aby atributy byly jedinečné pro každou položku ve skupině. Pro ilustraci tohoto bodu zvažte následující kód:

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <Item Include="1">
      <M>1</M>
    </Item>
    <Item Include="1">
      <M>2</M>
    </Item>
    <Item Include="2">
      <M>3</M>
    </Item>
  </ItemGroup>

  <Target Name="Batching">
    <Warning Text="@(Item->'%(Identity): %(M)')" Condition=" '%(Identity)' != '' "/>
  </Target>
</Project>

Výstup ukazuje, že první dvě položky jsou ve stejné dávce, protože Include atribut je pro ně stejný:

test.proj(15,5): warning : 1: 1;1: 2
test.proj(15,5): warning : 2: 3

Filtrování seznamů položek

Dávkování lze použít k vyfiltrování určitých položek ze seznamu položek před jeho předáním úkolu. Filtrování hodnoty Extension metadat známých položek například umožňuje spustit úlohu pouze na souborech s určitým rozšířením.

Následující příklad ukazuje, jak rozdělit seznam položek na dávky na základě metadat položek a potom tyto dávky filtrovat při jejich předání do úkolu. Seznam ExampColl položek je rozdělen do tří dávek na Number základě metadat položky. Atribut Condition úkolu určuje, že do úkolu budou předány pouze dávky s Number hodnotou 2 metadat položky.

<Project
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>

        <ExampColl Include="Item1">
            <Number>1</Number>
        </ExampColl>
        <ExampColl Include="Item2">
            <Number>2</Number>
        </ExampColl>
        <ExampColl Include="Item3">
            <Number>3</Number>
        </ExampColl>
        <ExampColl Include="Item4">
            <Number>1</Number>
        </ExampColl>
        <ExampColl Include="Item5">
            <Number>2</Number>
        </ExampColl>
        <ExampColl Include="Item6">
            <Number>3</Number>
        </ExampColl>

    </ItemGroup>

    <Target Name="Exec">
        <Message
            Text = "Items in ExampColl: @(ExampColl)"
            Condition="'%(Number)'=='2'"/>
    </Target>

</Project>

Úloha Zpráva zobrazí následující informace:

Items in ExampColl: Item2;Item5

Související obsah