共用方式為

FindUnderPath 工作

  • 發行項

判斷指定項目集合中哪些項目的路徑位於指定資料夾或其子資料夾中。

參數

下表說明 FindUnderPath 工作的參數。

參數 描述
Files 選擇性的 ITaskItem[] 參數。

指定其路徑應該與 Path 參數所指定的路徑進行比較的檔案。
InPath 選擇性的 ITaskItem[] 輸出參數。

包含指定路徑下找到的項目。
OutOfPath 選擇性的 ITaskItem[] 輸出參數。

包含指定路徑下未找到的項目。
Path 必要的 ITaskItem 參數。

指定要作為參考的資料夾路徑。
UpdateToAbsolutePaths 選擇性的 Boolean 參數。

如果輸出項目的路徑已更新為絕對路徑，則為 true。

備註

除了上述所列的參數，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。 如需這些其他參數的清單及其描述，請參閱 TaskExtension 基底類別。

範例

下列範例使用 FindUnderPath 工作，來判斷 MyFiles 項目中所包含的檔案路徑是否已存在於 SearchPath 屬性指定的路徑下。 工作完成之後，FilesNotFoundInPath 項目包含 File1.txt 檔案，而 FilesFoundInPath 項目包含 File2.txt 檔案。

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <MyFiles Include="C:\File1.txt" />
        <MyFiles Include="C:\Projects\MyProject\File2.txt" />
    </ItemGroup>

    <PropertyGroup>
        <SearchPath>C:\Projects\MyProject</SearchPath>
    </PropertyGroup>

    <Target Name="FindFiles">
        <FindUnderPath
            Files="@(MyFiles)"
            Path="$(SearchPath)">
            <Output
                TaskParameter="InPath"
                ItemName="FilesFoundInPath" />
            <Output
                TaskParameter="OutOfPath"
                ItemName="FilesNotFoundInPath" />
        </FindUnderPath>
    </Target>

</Project>

另請參閱