CreateItem-Aufgabe

Artikel
08/10/2011

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	Beschreibungen
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")

MySourceItemsWithMetadata

file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben

Share via