CreateItem 工作

  • 發行項

使用輸入項目填入項目集合。 這可將項目從一個清單複製到另一個。

注意

此工作已被取代。 從 .NET Framework 3.5 開始，項目 (Item) 群組可以放在 Target 項目 (Element) 內。 如需詳細資訊，請參閱項目。

屬性

下表說明 CreateItem 工作的參數。

參數 描述
AdditionalMetadata 選擇性 String 陣列參數。

指定要附加至輸出項目的其他中繼資料。 使用下列語法來指定項目的中繼資料名稱和值：

MetadataName=MetadataValue

您應該使用分號來分隔多個中繼資料名稱/值組。 如果名稱或值包含分號或其他任何特殊字元，則必須逸出它們。 如需詳細資訊，請參閱如何：在 MSBuild 中逸出特殊字元。
Exclude 選擇性的 ITaskItem[] 輸出參數。

指定要從輸出項目集合中排除的項目。 此參數可以包含萬用字元規格。 如需詳細資訊，請參閱項目和如何︰從組建中排除檔案。
Include 必要的 ITaskItem[] 參數。

指定要包含在輸出項目集合中的項目。 此參數可以包含萬用字元規格。
PreserveExistingMetadata 選擇性的 Boolean 參數。

如果是 True，僅會套用其他中繼資料 (如果它們還不存在)。

備註

除了上述所列的參數，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。 如需這些其他參數的清單及其描述，請參閱 TaskExtension 基底類別。

範例

下列程式碼範例會從項目集合 MySourceItems 建立名為 MySourceItemsWithMetadata 的新項目集合。 CreateItem 工作會使用 MySourceItems 項目中的項目來填入新的項目集合。 接著它會將名為 MyMetadata 且值為 Hello 的其他中繼資料項目 (Entry) 加入至新集合中的每個項目 (Item)。

執行此工作之後，MySourceItemsWithMetadata 項目 (Item) 集合會包含 file1.resx 和 file2.resx 項目，這兩者皆擁有 MyMetadata 的中繼資料項目 (Entry)。 MySourceItems 項目集合會保持不變。

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

下表描述工作執行之後輸出項目的值。 專案元數據會顯示在項目之後的括弧中。

項目集合。 目錄
MySourceItemsWithMetadata file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

另請參閱