Udostępnij za pośrednictwem

CreateItem — zadanie

Wypełnia kolekcje elementów elementami wejściowymi. Umożliwia to skopiowanie elementów z jednej listy do innej.

Uwaga

To zadanie jest przestarzałe. Począwszy od programu .NET Framework 3.5, grupy elementów mogą być umieszczane w elementach docelowych . Aby uzyskać więcej informacji, zobacz Elementy.

Atrybuty

W poniższej tabeli opisano parametry CreateItem zadania.

Parametr Opis
AdditionalMetadata Opcjonalny String parametr tablicy.

Określa dodatkowe metadane do dołączenia do elementów wyjściowych. Określ nazwę i wartość metadanych dla elementu przy użyciu następującej składni:

MetadataName = MetadataValue

Wiele par nazw/wartości metadanych powinno być rozdzielonych średnikami. Jeśli nazwa lub wartość zawiera średnik lub inne znaki specjalne, należy je użyć jako ucieczki. Aby uzyskać więcej informacji, zobacz How to: Escape special characters in MSBuild (Instrukcje: ucieczka znaków specjalnych w programie MSBuild).
Exclude Opcjonalny ITaskItem[] parametr wyjściowy.

Określa elementy do wykluczenia z kolekcji elementów wyjściowych. Ten parametr może zawierać specyfikacje symboli wieloznacznych. Aby uzyskać więcej informacji, zobacz Elementy i Instrukcje: wykluczanie plików z kompilacji.
Include Wymagany parametr interfejsu ITaskItem[].

Określa elementy do uwzględnienia w kolekcji elementów wyjściowych. Ten parametr może zawierać specyfikacje symboli wieloznacznych.
PreserveExistingMetadata Opcjonalny Boolean parametr.

Jeśli Trueprogram zastosuje dodatkowe metadane tylko wtedy, gdy jeszcze nie istnieją.

Uwagi

Oprócz parametrów wymienionych powyżej to zadanie dziedziczy parametry z TaskExtension klasy, która sama dziedziczy z Task klasy. Aby uzyskać listę tych dodatkowych parametrów i ich opisy, zobacz TaskExtension, klasa bazowa.

Przykład

Poniższy przykład kodu tworzy nową kolekcję elementów o nazwie MySourceItemsWithMetadata z kolekcji MySourceItemselementów . Zadanie CreateItem wypełnia nową kolekcję elementów elementami w elemencie MySourceItems . Następnie dodaje dodatkowy wpis metadanych o nazwie MyMetadata z wartością Hello do każdego elementu w nowej kolekcji.

Po wykonaniu MySourceItemsWithMetadata zadania kolekcja elementów zawiera elementy file1.resx i file2.resx, zarówno z wpisami metadanych dla MyMetadata. Kolekcja MySourceItems elementów pozostaje niezmieniona.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <MySourceItems Include="file1.resx;file2.resx" />
    </ItemGroup>

    <Target Name="NewItems">
        <CreateItem
            Include="@(MySourceItems)"
            AdditionalMetadata="MyMetadata=Hello">
           <Output
               TaskParameter="Include"
               ItemName="MySourceItemsWithMetadata"/>
        </CreateItem>

    </Target>

</Project>

W poniższej tabeli opisano wartość elementu wyjściowego po wykonaniu zadania. Metadane elementu są wyświetlane w nawiasach po elemencie.

Kolekcja elementów Zawartość
MySourceItemsWithMetadata file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

Zobacz też