Freigeben über

CreateItem-Aufgabe

Aktualisiert: November 2007

Füllt Elementauflistungen mit Eingabeelementen auf. Auf diese Weise können Elemente aus einer Liste in eine andere kopiert werden.

Attribute

In der folgenden Tabelle werden die Parameter der CreateItem-Aufgabe beschrieben.

Parameter

Beschreibung

AdditionalMetadata

Optionaler String-Parameter.

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:

MetadataName=MetadataValue

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 hierzu finden Sie unter Gewusst wie: Escapesonderzeichen in MSBuild.

Exclude

Optionaler ITaskItem[]-Parameter.

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: Erstellen aller Dateien in einem Verzeichnis mit Ausnahme einer Datei.

Include

Optionaler ITaskItem[]-Ausgabeparameter.

Gibt die Elemente an, die in die Ausgabeelementauflistung eingeschlossen werden sollen. Dieser Parameter kann Platzhalter enthalten.

Beispiel

Im folgenden Codebeispiel wird auf Grundlage der Elementauflistung MySourceItems eine neue Elementauflistung mit dem Namen MySourceItemsWithMetadata erstellt. Die CreateItem-Aufgabe füllt die neue Elementauflistung mit den Elementen aus der MySourceItems-Elementauflistung auf, die für MyAddMetadata den Wert true aufweisen. 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 file3.resx, die jeweils Metadateneinträge für MyAddMetadata und MyMetadata enthalten. Die MySourceItems-Elementauflistung ist unverändert.

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

    <ItemGroup>
        <MySourceItems Include="file1.resx;file3.resx">
            <MyAddMetadata>true</MyAddMetadata>
        </MySourceItems>
        <MySourceItems Include="file2.resx">
            <MyAddMetadata>false</MyAddMetadata>
        </MySourceItems>
    </ItemGroup>

    <PropertyGroup>
        <MyValue>Hello</MyValue>
    </PropertyGroup>

    <Target Name="NewItems">

        <CreateItem
            Include="@(MySourceItems)"
            Condition="'%(MyAddMetadata)'=='true'"
            AdditionalMetadata="MyMetadata=$(MyValue)">

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

file3.resx (MyMetadata="Hello")

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben

  • Last updated on