CreateItem — Zadanie
Wypełnia elementu kolekcji elementów wejściowych.Pozwala to elementy, które mają być kopiowane z jednej listy do innej.
[!UWAGA]
To zadanie jest niezalecane.Począwszy od.NET Framework 3.5, grup towarów może być umieszczone wewnątrz docelowej elementy.Aby uzyskać więcej informacji, zobacz Elementy programu MSBuild.
Atrybuty
W poniższej tabeli opisano parametry CreateItem zadania.
Parametr |
Opis |
|---|---|
AdditionalMetadata |
Opcjonalny String parametr array. Określa dodatkowe metadane, aby dołączyć do elementów danych wyjściowych.Określ nazwę metadane i wartość dla elementu z następującej składni: MetadataName=MetadataValue Wiele par nazwa/wartość metadanych powinny być oddzielone średnikiem.Jeśli nazwa lub wartość zawiera średnikiem lub inne znaki specjalne, musi być wyjściowym.Aby uzyskać więcej informacji, zobacz Porady: znaki specjalne ucieczki w MSBuild. |
Exclude |
Opcjonalny ITaskItem[] parametr wyjścia. Określa elementy, które mają być wykluczone z kolekcji elementów danych wyjściowych.Ten parametr może zawierać specyfikacji symbolu wieloznacznego.Aby uzyskać więcej informacji, zobacz Elementy programu MSBuild i Porady: wykluczanie plików z kompilacji. |
Include |
Wymagane ITaskItem[]parametru. Określa produkty, które mają zostać uwzględnione w danych wyjściowych kolekcji elementów.Ten parametr może zawierać specyfikacji symbolu wieloznacznego. |
PreserveExistingMetadata |
Opcjonalny Boolean parametru. Jeśli True, tylko, jeśli jeszcze nie istnieje, stosuje się dodatkowe metadane. |
Uwagi
Oprócz parametrów wymienionych powyżej, to zadanie dziedziczy parametry z TaskExtension , które sama klasa dziedziczy z Task klasy.Aby uzyskać listę tych dodatkowych parametrów, a ich opisy, zobacz TaskExtension — Klasa podstawowa.
Przykład
Poniższy przykład kodu tworzy nową kolekcję element o nazwie MySourceItemsWithMetadata z kolekcji elementów MySourceItems.CreateItem Zadanie wypełnia nowej kolekcji elementów z elementami w MySourceItems element.Następnie dodaje dodatkowe metadane wpis o nazwie MyMetadata o wartości Hello do każdego elementu w nowej kolekcji.
Po wykonaniu zadania MySourceItemsWithMetadata kolekcji elementów zawiera elementy file1.resx i file2.resx, oba wpisy metadanych dla MyMetadata.MySourceItems Kolekcji elementów pozostaje niezmieniona.
<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>
W poniższej tabeli opisano wartość elementu danych wyjściowych, po wykonaniu zadania.Element metadanych podano w nawiasach po elemencie.
Element kolekcji |
Zawartość |
|---|---|
MySourceItemsWithMetadata |
file1.resx (MyMetadata="Hello") file2.resx (MyMetadata="Hello") |