CreateItem – úloha

  • Článek

Naplní kolekce položek vstupními položkami. To umožňuje zkopírování položek z jednoho seznamu do druhého.

Poznámka:

Tato úloha je zastaralá. Počínaje rozhraním .NET Framework 3.5 mohou být skupiny položek umístěny do cílových prvků. Další informace naleznete v tématu Položky.

Atributy

Následující tabulka popisuje parametry CreateItem úlohy.

Parametr Popis
AdditionalMetadata Volitelný String parametr pole.

Určuje další metadata pro připojení k výstupním položkám. Zadejte název a hodnotu metadat položky s následující syntaxí:

MetadataName=MetadataValue

Pár názvů a hodnot více metadat by se měl oddělit středníkem. Pokud název nebo hodnota obsahuje středník nebo jiné speciální znaky, musí být uchycené. Další informace naleznete v tématu Postupy: Řídicí speciální znaky v nástroji MSBuild.
Exclude Volitelný ITaskItem[] výstupní parametr.

Určuje položky, které mají být vyloučeny z kolekce výstupních položek. Tento parametr může obsahovat specifikace zástupných znaků. Další informace naleznete v tématu Položky a postupy: Vyloučení souborů z sestavení.
Include Požadovaný parametr ITaskItem[].

Určuje položky, které se mají zahrnout do kolekce výstupních položek. Tento parametr může obsahovat specifikace zástupných znaků.
PreserveExistingMetadata Volitelný Boolean parametr.

Pokud True, použijte pouze další metadata, pokud ještě neexistují.

Poznámky

Kromě výše uvedených parametrů tato úloha dědí parametry z TaskExtension třídy, která sama dědí z Task třídy. Seznam těchto dalších parametrů a jejich popisů naleznete v tématu TaskExtension základní třída.

Příklad

Následující příklad kódu vytvoří novou kolekci položek pojmenovanou MySourceItemsWithMetadata z kolekce MySourceItemspoložek . Úkol CreateItem naplní novou kolekci položek položkami v MySourceItems položce. Potom přidá další položku MyMetadata metadat pojmenovanou s hodnotou Hello každé položky v nové kolekci.

Po provedení MySourceItemsWithMetadata úkolu kolekce položek obsahuje položky file1.resx a file2.resx, a to jak s položkami metadat pro MyMetadata. Kolekce MySourceItems položek se nezmění.

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

    <ItemGroup>
        <MySourceItems Include="file1.resx;file2.resx" />
    </ItemGroup>

    <Target Name="NewItems">
        <CreateItem
            Include="@(MySourceItems)"
            AdditionalMetadata="MyMetadata=Hello">
           <Output
               TaskParameter="Include"
               ItemName="MySourceItemsWithMetadata"/>
        </CreateItem>

    </Target>

</Project>

Následující tabulka popisuje hodnotu výstupní položky po spuštění úkolu. Metadata položek se zobrazují v závorkách za položkou.

Kolekce položek Obsah
MySourceItemsWithMetadata file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

Viz také