CreateItem-Aufgabe

  • Artikel

Füllt Elementauflistungen mit den Eingabeelementen aus. Dadurch können Elemente aus einer Liste in eine andere kopiert werden.

Hinweis

Diese Aufgabe ist veraltet. Seit .NET Framework 3.5 können Elementgruppen innerhalb von Ziel-Elementen platziert werden. Weitere Informationen finden Sie unter Elemente.

Attribute

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

Parameter Beschreibung
AdditionalMetadata Optionaler 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:

MetadataName = MetadataValue

Mehrere Metadaten-Name/Wert-Paare sollten mit einem Semikolon getrennt werden. Wenn entweder der Name oder der Wert ein Semikolon oder andere Sonderzeichen enthält, müssen sie mit einem Escapezeichen versehen werden. Weitere Informationen finden Sie unter Vorgehensweise: 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 Elemente und Vorgehensweise: Ausschließen von Dateien vom Buildvorgang.
Include Erforderlicher ITaskItem-[]-Parameter

Gibt die Elemente an, die in die Ausgabeelementauflistung einbezogen werden sollen. Dieser Parameter kann Platzhalter enthalten.
PreserveExistingMetadata Optionaler Boolean-Parameter.

Bei True gelten nur die zusätzlichen Metadaten, 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 eine neue Elementauflistung namens MySourceItemsWithMetadata aus der Elementauflistung MySourceItems erstellt. Die CreateItem-Aufgabe füllt die neuen Elementauflistungen mit den Elementen im MySourceItems-Element auf. Anschließend fügt es jedem Element in der neuen Sammlung einen zusätzlichen Metadateneintrag namens MyMetadata mit dem Wert Hello hinzu.

Nachdem die Aufgabe ausgeführt wurde, enthält die MySourceItemsWithMetadata-Elementsammlung die Elemente file1.resx und file2.resx, und beide verfügen über Metadateneinträge für MyMetadata. Die MySourceItems-Elementauflistung bleibt unverändert.

<Project xmlns="http://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 Inhalte
MySourceItemsWithMetadata file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

Weitere Informationen