CreateItem görevi

  • Makale

Öğe koleksiyonlarını giriş öğeleriyle doldurur. Bu, öğelerin bir listeden diğerine kopyalanmasına olanak tanır.

Dekont

Bu görev kullanım dışı bırakıldı. .NET Framework 3.5'den başlayarak, öğe grupları Hedef öğelere yerleştirilebilir. Daha fazla bilgi için bkz . Öğeler.

Öznitelikler

Aşağıdaki tabloda görevin parametreleri CreateItem açıklanmaktadır.

Parametre Tanım
AdditionalMetadata İsteğe bağlı String dizi parametresi.

Çıkış öğelerine eklenecek ek meta verileri belirtir. Öğenin meta veri adını ve değerini aşağıdaki söz dizimiyle belirtin:

MetadataName=MetadataValue

Birden çok meta veri adı/değer çifti noktalı virgülle ayrılmalıdır. Ad veya değer noktalı virgül veya başka bir özel karakter içeriyorsa, bunların kaçılması gerekir. Daha fazla bilgi için bkz . Nasıl yapılır: MSBuild'de özel karakterlerin kaçışı.
Exclude İsteğe bağlı ITaskItem[] çıkış parametresi.

Çıkış öğesi koleksiyonundan dışlanması gereken öğeleri belirtir. Bu parametre joker karakter belirtimleri içerebilir. Daha fazla bilgi için bkz . Öğeler ve Nasıl yapılır: Dosyaları derlemenin dışında tutma.
Include Gerekli ITaskItem[] parametresi.

Çıkış öğesi koleksiyonuna eklenecek öğeleri belirtir. Bu parametre joker karakter belirtimleri içerebilir.
PreserveExistingMetadata İsteğe bağlı Boolean parametre.

ise True, ek meta verileri yalnızca henüz yoksa uygulayın.

Açıklamalar

Yukarıda listelenen parametrelere ek olarak, bu görev kendi sınıfından TaskExtension devralan sınıfından Task parametreleri devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . TaskExtension temel sınıfı.

Örnek

Aşağıdaki kod örneği, öğe koleksiyonundan adlı MySourceItemsWithMetadata yeni bir öğe koleksiyonu MySourceItemsoluşturur. Görev, CreateItem yeni öğe koleksiyonunu öğedeki MySourceItems öğelerle doldurur. Ardından, yeni koleksiyondaki her öğeye değeri Hello ile adlı MyMetadata ek bir meta veri girişi ekler.

Görev yürütüldükten sonra, MySourceItemsWithMetadata öğe koleksiyonu file1.resx ve file2.resx öğelerini içerir ve her ikisi de için MyMetadatameta veri girdileri içerir. Öğe MySourceItems koleksiyonu değiştirilmez.

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

Aşağıdaki tabloda, görev yürütmeden sonra çıkış öğesinin değeri açıklanmaktadır. Öğe meta verileri, öğeden sonra parantez içinde gösterilir.

Öğe koleksiyonu İçindekiler
MySourceItemsWithMetadata file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

Ayrıca bkz.