İtem öðesini (MSBuild)

Makale
02/26/2013

Kullanıcı tanımlı öğe ve meta verileri içerir.Kullanılan her öğe bir MSBuild proje alt öğesi olarak belirtilmesi gerekir bir ItemGroup öğesi.

<Item Include="*.cs"
        Exclude="MyFile.cs"
        Remove="RemoveFile.cs"
        Condition="'String A'=='String B'" >
    <ItemMetadata1>...</ItemMetadata1>
    <ItemMetadata2>...</ItemMetadata2>
</Item>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Tanımlama
Include	Gerekli öznitelik. Dosya veya öğeler listesinde eklemek için joker karakter.
Exclude	İsteğe bağlı öznitelik. Dosya veya öğe listesinden çıkarmak için joker karakter.
Condition	İsteğe bağlı öznitelik. Değerlendirilecek koşulu.Daha fazla bilgi için bkz. MSBuild koşulları.
Remove	İsteğe bağlı öznitelik. Dosya veya öğe listesinden kaldırmak için joker karakter. Bu öznitelik için bir öğeyi yalnızca belirtilen geçerli bir ItemGroup olan bir Target.
KeepMetadata	İsteğe bağlı öznitelik. Hedef öğe eklemek kaynak öğeler için meta veriler.Adları noktalı virgülle ayrılmış bir listede belirtilen yalnızca meta veriler aktarılmış bir kaynak öğesi bir hedef öğe.Daha fazla bilgi için bkz. MSBuild öğeleri. Bu öznitelik için bir öğeyi yalnızca belirtilen geçerli bir ItemGroup olan bir Target.
RemoveMetadata	İsteğe bağlı öznitelik. Hedef öğe değil transfer etmek kaynak öğeler için meta veriler.Tüm meta veri kaynağı öğesinden hedef öğe meta verileri dışında adlarını noktalı virgülle ayrılmış liste adları bulunan transfer edilir.Daha fazla bilgi için bkz. MSBuild öğeleri. Bu öznitelik için bir öğeyi yalnızca belirtilen geçerli bir ItemGroup olan bir Target.
KeepDuplicates	İsteğe bağlı öznitelik. Bir öğeyi varolan bir maddeyi tamamen aynısı ise hedef gruba eklenip eklenmeyeceğini belirtir.Aynı kaynak ve hedef öğesi varsa, Include , ancak farklı meta veri değeri, bu madde, eklenen bile KeepDuplicates ayarlamak false.Daha fazla bilgi için bkz. MSBuild öğeleri. Bu öznitelik için bir öğeyi yalnızca belirtilen geçerli bir ItemGroup olan bir Target.

Alt Öğeler

Öge	Tanımlama
ItemMetadata	Öğe meta veri değeri içeren bir kullanıcı tanımlı meta veriler, öğe anahtarı.Sıfır veya daha fazla olabilir ItemMetadata öğelerin öğe.

Üst Öğeler

Öge	Tanımlama
ItemGroup	Öğeleri gruplandırma öğesi.

Notlar

Itemöğeleri yapı sisteme giriş tanımlamak ve kendi kullanıcı tanımlı topluluk adlarını temel alarak madde koleksiyonları halinde gruplandırılır.Bu öğe koleksiyon için bir parametre olarak kullanılan görevleri, kullanın tek tek öğeler koleksiyonu oluşturma işleminin adımları gerçekleştirmek için.Daha fazla bilgi için bkz. MSBuild öğeleri.

Gösterimini kullanarak @(myType) türündeki öğeler topluluğu sağlar myType bir noktalı virgülle ayrılmış listesini dizeleri genişletilmiş ve bir parametre geçirildi.Parametre türü ise string, sonra da parametre değeri öğeleri noktalı virgülle ayrılmış listesidir.Parametre bir dize dizisi ise (string[]), sonra da her öğeyi noktalı virgül konumu esas alarak dizi eklenir.Görev parametre türü ise ITaskItem[], değerini eklenmiş herhangi bir meta veri ile birlikte öğe koleksiyonunun içeriğini sonra.Her öğeyi noktalı dışında bir karakter kullanarak sınırlandırmak için sözdizimini @(myType, 'ayırıcı').

MSBuild Motoru değerlendirmek joker karakterler gibi * ve ? ve özyinelemeli joker karakterler gibi /**/*.cs.Daha fazla bilgi için bkz. MSBuild öğeleri.

Örnek

Aşağıdaki kod örneği, iki öğe türünde bildirmek gösterilmiştir CSFile.İkinci olarak bildirilen madde olan meta verileri içeren myAttribute ayarlamak HelloWorld.

<ItemGroup>
    <CSFile Include="engine.cs; form.cs" />
    <CSFile Include="main.cs" >
        <MyMetadata>HelloWorld</MyMetadata>
    </CSFile>
</ItemGroup>

Ayrıca bkz.

Kavramlar

MSBuild öğeleri

MSBuild özellikleri

MSBuild proje dosyası Şeması Başvurusu

Aracılığıyla paylaş