ItemGroup öğesi (MSBuild)

  • Makale

Kullanıcı tanımlı Öğe öğeleri kümesi içerir. MSBuild projesinde kullanılan her öğe bir ItemGroup öğenin alt öğesi olarak belirtilmelidir.

<Project><ItemGroup>

Sözdizimi

<ItemGroup Condition="'String A' == 'String B'"
           Label="Label">
    <Item1>... </Item1>
    <Item2>... </Item2>
</ItemGroup>

Öznitelikler ve öğeler

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

Öznitelikler

Öznitelik Tanım
Condition İsteğe bağlı öznitelik. Değerlendirilecek koşul. Daha fazla bilgi için bkz . Koşullar.
Label İsteğe bağlı öznitelik. öğesini ItemGrouptanımlar.

Alt öğeleri

Öğe Tanım
Kalem Derleme işlemi için girişleri tanımlar. içinde sıfır veya daha fazla Item öğe ItemGroupolabilir.

ItemGroup, genel Item öğeye ek olarak, Common MSBuild proje öğelerinde listelendiği gibi , ProjectReference, Compileve diğerleri gibi Referenceöğe türlerini temsil eden alt öğelere izin verir.

Üst öğeler

Öğe Tanım
Proje MSBuild proje dosyasının gerekli kök öğesi.
Hedef .NET Framework 3.5'den başlayarak, ItemGroup öğesi bir Target öğenin içinde görünebilir. Daha fazla bilgi için bkz . Hedefler.

Örnek

Aşağıdaki kod örneği, kullanıcı tanımlı öğe koleksiyonlarını ResCodeFiles ve bir ItemGroup öğenin içinde bildirerek gösterir. Öğe koleksiyonundaki Res öğelerin her biri kullanıcı tanımlı bir alt ItemMetadata öğesi içerir.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <Res Include = "Strings.fr.resources" >
            <Culture>fr</Culture>
        </Res>
        <Res Include = "Dialogs.fr.resources" >
            <Culture>fr</Culture>
        </Res>

        <CodeFiles Include="**\*.cs" Exclude="**\generated\*.cs" />
        <CodeFiles Include="..\..\Resources\Constants.cs" />
    </ItemGroup>
...
</Project>

Basit bir proje dosyasında normalde tek ItemGroup bir öğe kullanırsınız, ancak birden çok ItemGroup öğe de kullanabilirsiniz. Birden çok ItemGroup öğe kullanıldığında, öğeler tek ItemGroupbir öğesinde birleştirilir. Örneğin, bazı öğeler içeri aktarılan bir dosyada tanımlanan ayrı ItemGroup bir öğe tarafından eklenebilir.

ItemGroups özniteliği kullanılarak Condition uygulanan koşullara sahip olabilir. Bu durumda, öğeler yalnızca koşul karşılanırsa öğe listesine eklenir. Bkz. MSBuild koşulları

Label özniteliği bazı derleme sistemlerinde derleme davranışlarını denetlemenin bir yolu olarak kullanılır. Bunu yalnızca bildirimlerde, daha anlaşılır MSBuild betikleri oluşturmanın bir yolu olarak veya derleme eylemlerini etkileyen bir denetim ayarı olarak kullanabilirsiniz.

Ayrıca bkz.