ItemGroup öğesi (MSBuild)

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

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

Attributes

Özellik Description
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 öğeler

Öğe Description
Öğe 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 Description
Proje MSBuild proje dosyasının gerekli kök öğesi.
Hedef ItemGroup öğesi bir Target öğenin içinde görünebilir. Daha fazla bilgi için bkz. Hedefler.

Example

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>
    <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 bakınız