CreateItem úloh
Naplní kolekce položku vstupní položky.To umožňuje položky kopírovat z jednoho seznamu do druhého.
[!POZNÁMKA]
Tento úkol se již nepoužívá.Počínaje.NET Framework 3.5 skupiny zboží může být umístěna v Target prvky.Další informace naleznete v tématu Nástroj MSBuild položky.
v případě vícehodnotových atributů
Následující tabulka popisuje parametry CreateItem úkolu.
Parametr |
Description |
|---|---|
AdditionalMetadata |
Volitelný String parametr pole. Určuje další metadata k výstupu položek.Zadejte název metadat a hodnotu pro položku s následující syntaxí: MetadataName=MetadataValue Více dvojic název hodnota metadat je třeba oddělit středníkem.Pokud název nebo hodnotu obsahuje středník nebo jiné speciální znaky, je nutné uvést.Další informace naleznete v tématu Jak: speciální znaky v MSBuild Escape. |
Exclude |
Volitelný ITaskItem[] výstupní parametr. Určuje položky z kolekce výstup zboží.Tento parametr může obsahovat specifikaci zástupných znaků.Další informace naleznete v tématu Nástroj MSBuild položky a Jak: vyloučení souborů ze sestavení. |
Include |
Požadované ITaskItem[]parametr. Určuje zboží chcete zahrnout do výstupu kolekci položek.Tento parametr může obsahovat specifikaci zástupných znaků. |
PreserveExistingMetadata |
Volitelný Boolean parametr. Pokud True, platí pouze další metadata, pokud již neexistují. |
Poznámky
Vedle výše uvedených parametrů, zdědí tento úkol parametry z TaskExtension dědí třídu, která sama Task třídy.Seznam těchto další parametry a jejich popis naleznete v TaskExtension základní třída.
Příklad
Následující příklad kódu vytvoří novou položku kolekce s názvem MySourceItemsWithMetadata z kolekce položku MySourceItems.CreateItem Úloh naplní nové kolekce položek s položkami v MySourceItems zboží.Přidá další metadata položky s názvem MyMetadata s hodnotou Hello na jednotlivé položky v nové kolekce.
Po provedení úkolu MySourceItemsWithMetadata položku kolekce obsahuje položky file1.resx a file2.resx, i položek metadat pro MyMetadata.MySourceItems Kolekce položek zůstane nezměněna.
<Project xmlns="https://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 hodnoty výstupu zboží po provedení úlohy.Metadata položky se zobrazí v závorkách za položkou.
Kolekce položek |
Obsah |
|---|---|
MySourceItemsWithMetadata |
file1.resx (MyMetadata="Hello") file2.resx (MyMetadata="Hello") |