CreateItem-Aufgabe
Füllt Elementauflistungen mit Eingabeelementen auf. Auf diese Weise können Elemente aus einer Liste in eine andere kopiert werden.
Hinweis
Diese Aufgabe ist veraltet.Ab .NET Framework 3.5 können Elementgruppen in Zielelemente platziert werden.Weitere Informationen finden Sie unter MSBuild-Elemente.
Attribute
In der folgenden Tabelle werden die Parameter der CreateItem-Aufgabe beschrieben.
Parameter |
Beschreibung |
---|---|
AdditionalMetadata |
Optionale String-Arrayparameter. Gibt zusätzliche Metadaten an, die an die Ausgabeelemente angefügt werden sollen. Geben Sie den Metadatennamen und -wert für das Element mit der folgenden Syntax an: Metadatenname=Metadatenwert Mehrere Metadatenname/Wert-Paare müssen durch Semikolons voneinander getrennt werden. Semikolons oder andere Sonderzeichen in einem Namen oder Wert müssen mit Escapezeichen versehen werden. Weitere Informationen finden Sie unter Gewusst wie: Escapesonderzeichen in MSBuild. |
Exclude |
Optionaler ITaskItem[]-Ausgabeparameter. Gibt die Elemente an, die aus der Ausgabeelementauflistung ausgeschlossen werden sollen. Dieser Parameter kann Platzhalter enthalten. Weitere Informationen finden Sie unter MSBuild-Elemente und Gewusst wie: Ausschließen von Dateien vom Buildvorgang. |
Include |
Erforderlicher ITaskItem[]-Parameter. Gibt die Elemente an, die in die Ausgabeelementauflistung eingeschlossen werden sollen. Dieser Parameter kann Platzhalter enthalten. |
PreserveExistingMetadata |
Optionaler Boolean-Parameter. Bei True werden nur die zusätzliche Metadaten angewendet, wenn sie nicht bereits vorhanden sind. |
Hinweise
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der TaskExtension-Klasse, die selbst von der Task-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.
Beispiel
Im folgenden Codebeispiel wird auf Grundlage der Elementauflistung MySourceItems eine neue Elementauflistung mit dem Namen MySourceItemsWithMetadata erstellt. Die neue Elementsammlung wird von der CreateItem-Aufgabe mit den neuen Elementen im MySourceItems-Element ausgefüllt. Anschließend wird jedem Element in der neuen Auflistung ein zusätzlicher Metadateneintrag mit dem Namen MyMetadata und dem Wert Hello hinzugefügt.
Nach der Ausführung der Aufgabe enthält die MySourceItemsWithMetadata-Elementauflistung die Elemente file1.resx und file2.resx, die jeweils Metadateneinträge für MyMetadata enthalten. Die MySourceItems-Elementauflistung ist unverändert.
<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>
In der folgenden Tabelle wird der Wert des Ausgabeelements nach der Ausführung der Aufgabe beschrieben. Elementmetadaten werden in Klammern nach dem Element angezeigt.
Elementauflistung |
Inhalt |
---|---|
MySourceItemsWithMetadata |
file1.resx (MyMetadata="Hello") file2.resx (MyMetadata="Hello") |