항목 함수 작업

  • 아티클

작업 및 대상의 코드는 프로젝트의 항목에 대한 정보를 얻기 위해 항목 함수를 호출할 수 있습니다(MSBuild 4.0 이상). 이러한 함수를 사용하면 고유 항목을 간편하게 가져올 수 있으며 항목을 반복하는 방식보다 속도도 더 빠릅니다.

문자열 항목 함수

.NET Framework에서 문자열 메서드 및 속성을 사용하여 모든 항목 값을 작동할 수 있습니다. String 메서드의 경우 메서드 이름을 지정합니다. String 속성의 경우 "get_" 뒤에 속성 이름을 지정합니다.

여러 문자열에 있는 항목의 경우 문자열 메서드 또는 속성이 각 문자열에서 실행됩니다.

다음 예제에서는 이러한 문자열 항목 함수를 사용하는 방법을 보여 줍니다.

<ItemGroup>
    <theItem Include="andromeda;tadpole;cartwheel" />
</ItemGroup>

<Target Name = "go">
    <Message Text="IndexOf  @(theItem->IndexOf('r'))" />
    <Message Text="Replace  @(theItem->Replace('tadpole', 'pinwheel'))" />
    <Message Text="Length   @(theItem->get_Length())" />
    <Message Text="Chars    @(theItem->get_Chars(2))" />
</Target>

  <!--
  Output:
    IndexOf  3;-1;2
    Replace  andromeda;pinwheel;cartwheel
    Length   9;7;9
    Chars    d;d;r
  -->

내장 항목 함수

아래 표는 항목에 사용할 수 있는 내장 함수를 나열합니다.

함수 예제 설명
Combine @(MyItems->Combine('path')) 모든 입력 항목에 지정된 상대 경로가 추가된 새 항목 집합을 반환합니다.
Count @(MyItems->Count()) 항목 수를 반환합니다.
DirectoryName @(MyItems->DirectoryName()) 각 항목에 대한 해당 Path.DirectoryName을 반환합니다.
Distinct @(MyItems->Distinct()) 고유한 Include 값이 있는 항목을 반환합니다. 메타데이터는 무시됩니다. 비교 시 대/소문자가 구분되지 않습니다.
DistinctWithCase @(MyItems->DistinctWithCase()) 고유한 itemspec 값이 있는 항목을 반환합니다. 메타데이터는 무시됩니다. 대/소문자를 구분하고 비교합니다.
Exists @(MyItems->Exists()) 항목 집합을 디스크에 실제로 존재하는 항목으로 필터링합니다.
GetPathsOfAllDirectoriesAbove @(MyItems->GetPathsOfAllFilesAbove()) 항목 집합이 지정되면 모든 상위 디렉터리를 나타내는 항목을 반환합니다. 순서가 보장되지 않습니다.
Reverse @(MyItems->Reverse()) 항목을 역순으로 반환합니다.
AnyHaveMetadataValue @(MyItems->AnyHaveMetadataValue("MetadataName", "MetadataValue")) 모든 항목에 지정된 메타데이터 이름 및 값이 있는지 여부를 나타내도록 boolean을 반환합니다. 비교 시 대/소문자가 구분되지 않습니다.
ClearMetadata @(MyItems->ClearMetadata()) 해당 메타데이터가 지워진 항목을 반환합니다. itemspec만 유지됩니다.
HasMetadata @(MyItems->HasMetadata("MetadataName")) 지정된 메타데이터 이름을 가진 항목을 반환합니다. 비교 시 대/소문자가 구분되지 않습니다.
Metadata @(MyItems->Metadata("MetadataName")) 메타데이터 이름을 포함하는 메타데이터의 값을 반환합니다. 반환된 항목에는 원본 값과 동일한 메타데이터가 있습니다.
WithMetadataValue @(MyItems->WithMetadataValue("MetadataName", "MetadataValue")) 지정된 메타데이터 이름 및 값을 가진 항목을 반환합니다. 비교 시 대/소문자가 구분되지 않습니다.

참고 항목

Exists는 MSBuild 조건(예: Condition="Exists('path')") 또는 정적 속성 함수(예: $([System.IO.File]::Exists("path")))와 같이 다른 컨텍스트에서도 사용할 수 있습니다.

다음 예제에서는 내장 항목 함수를 사용하는 방법을 보여 줍니다.

<ItemGroup>
    <TheItem Include="first">
        <Plant>geranium</Plant>
    </TheItem>
    <TheItem Include="second">
        <Plant>algae</Plant>
    </TheItem>
    <TheItem Include="third">
        <Plant>geranium</Plant>
    </TheItem>
</ItemGroup>

<Target Name="go">
    <Message Text="MetaData:    @(TheItem->Metadata('Plant'))" />
    <Message Text="HasMetadata: @(theItem->HasMetadata('Plant'))" />
    <Message Text="WithMetadataValue: @(TheItem->WithMetadataValue('Plant', 'geranium'))" />
    <Message Text=" " />
    <Message Text="Count:   @(theItem->Count())" />
    <Message Text="Reverse: @(theItem->Reverse())" />
</Target>

  <!--
  Output:
    MetaData:    geranium;algae;geranium
    HasMetadata: first;second;third
    WithMetadataValue: first;third

    Count:   3
    Reverse: third;second;first
  -->

메타데이터 항목 함수를 사용할 때 중복 검색

항목 함수는 Metadata 원본 항목의 원래 메타데이터를 유지합니다. 이는 반환된 항목이 중복되는지 여부를 고려할 때 몇 가지 의미가 있습니다. 중복 항목 처리 방법을 제어하려면 KeepDuplicates 특성을 사용할 수 있습니다. 필요 없는 경우 RemoveMetadata를 추가하여 메타데이터를 제거할 수도 있습니다. 이 경우 중복 항목을 검색할 때 값 자체만 고려됩니다.

  <Target Name="MetadataToItem">
    <ItemGroup>
      <Sample Include="AAA" SomeItems="1;2;3" />
      <Sample Include="BBB" SomeItems="3;4;5" />
    </ItemGroup>

    <ItemGroup>
      <AllSomeItems Include="@(Sample->Metadata('SomeItems'))" KeepDuplicates="false" />
    </ItemGroup>
    <Message Text="AllSomeItems is @(AllSomeItems)" />
  </Target>

출력은 다음과 같습니다.

MetadataToItem:
  AllSomeItems is 1;2;3;3;4;5

코드를 다음과 같이 변경하면 중복 항목 값이 성공적으로 검색되고 제거됩니다.

    <ItemGroup>
      <AllSomeItems Include="@(Sample->Metadata('SomeItems'))" KeepDuplicates="false" RemoveMetadata="SomeItems" />
    </ItemGroup>

MSBuild 조건 함수

함수 HasTrailingSlash는 항목 함수가 아닙니다. Condition 특성과 함께 사용할 수 있습니다. MSBuild 조건을 참조하세요.

관련 콘텐츠

속성을 사용하여 항목 메타데이터에 대한 필터링과 같은 항목 목록에 대한 작업을 수행할 수도 있습니다. 자세한 내용은 항목을 참조하세요.