Pozycja elementu (MSBuild)

Zawiera element użytkownika i jego metadane.Każdy element, który jest używany w MSBuild projekt musi być określona jako element podrzędny ItemGroup element.

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementów nadrzędnych.

Atrybuty

Atrybut	Opis
Include	Wymagany atrybut. Plik lub symboli wieloznacznych do umieszczenia na liście elementów.
Exclude	Atrybut opcjonalny. Plik lub symboli wieloznacznych, aby wykluczyć z listy elementów.
Condition	Atrybut opcjonalny. Szacowany warunek.Aby uzyskać więcej informacji, zobacz Program MSBuild warunki.
Remove	Atrybut opcjonalny. Plik lub symboli wieloznacznych, aby usunąć z listy elementów. Ten atrybut jest prawidłowy tylko wtedy, gdy jest on określony dla elementu w ItemGroup w Target.
KeepMetadata	Atrybut opcjonalny. Metadane dla elementów źródłowych, aby dodać do elementów docelowych.Metadane, których nazwy podano w rozdzielaną średnikami listę przenosi się z elementu źródłowego do elementu docelowego.Aby uzyskać więcej informacji, zobacz Program MSBuild elementów. Ten atrybut jest prawidłowy tylko wtedy, gdy jest on określony dla elementu w ItemGroup w Target.
RemoveMetadata	Atrybut opcjonalny. Metadane dla elementów źródłowych nie przenieść do elementów docelowych.Wszystkie metadane są przesyłane z elementu źródłowego do elementu docelowego, z wyjątkiem metadanych których nazwy są zawarte w rozdzielaną średnikami listę nazw.Aby uzyskać więcej informacji, zobacz Program MSBuild elementów. Ten atrybut jest prawidłowy tylko wtedy, gdy jest on określony dla elementu w ItemGroup w Target.
KeepDuplicates	Atrybut opcjonalny. Określa, czy element należy dodać do grupy docelowej, jeśli jest identyczna z istniejącego elementu.Jeśli element źródłowy i docelowy mają takie same Include , ale wartość metadanych, element jest dodane, nawet jeśli KeepDuplicates jest ustawiona na false.Aby uzyskać więcej informacji, zobacz Program MSBuild elementów. Ten atrybut jest prawidłowy tylko wtedy, gdy jest on określony dla elementu w ItemGroup w Target.

Elementy podrzędne

Element	Opis
ItemMetadata	Klucz metadanych zdefiniowane przez użytkownika element, który zawiera wartość elementu metadanych.Może być zero lub więcej ItemMetadata elementy w elemencie.

Elementy nadrzędne

Element	Opis
ItemGroup	Element grupowanie elementów.

Uwagi

Itemelementy zdefiniować wejść do systemu kompilacji i są pogrupowane w kolekcje towaru na podstawie ich nazw zdefiniowanych przez użytkownika zbioru.Te kolekcje element może być używany jako parametry dla zadania, które wykorzystują poszczególnych elementów w kolekcji kroki procesu tworzenia.Aby uzyskać więcej informacji, zobacz Program MSBuild elementów.

Przy użyciu notacji @(myType) umożliwia kolekcję elementów typu myType być rozszerzone do rozdzielaną średnikami listę ciągów i przekazywane do parametru.Jeśli parametr jest typu string, a następnie wartość parametru jest lista elementów, oddzielając je średnikami.Jeśli parametr jest tablica ciągów (string[]), a następnie każdy element jest wstawiany do tablicy, na podstawie lokalizacji średnikami.Jeśli parametr zadania jest typu ITaskItem[], a następnie wartość jest zawartość kolekcji elementów wraz z dowolnym metadanych dołączonych.Do rozdzielenia każdej pozycji za pomocą znak inny niż znak średnika, należy użyć składni @(myType, 'separatora').

MSBuild Silnika można ocenić symboli wieloznacznych, takich jak * i ? i cykliczne symboli wieloznacznych, takich jak /**/*.cs.Aby uzyskać więcej informacji, zobacz Program MSBuild elementów.

Przykład

Poniższy przykład kodu pokazuje, jak zadeklarować dwóch elementów typu CSFile.Drugi zadeklarowane element zawiera metadane, które ma myAttribute ustawiona na HelloWorld.

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

Zobacz też

Koncepcje

Program MSBuild elementów

Program MSBuild właściwości

Odwołanie do projektu programu MSBuild pliku schematu