ItemGroup öğesi (MSBuild)

Makale
10/13/2023

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

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 `ItemGroup`tanı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 `ItemGroup`olabilir.

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ı Res CodeFiles 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.

Aracılığıyla paylaş