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>

另请参阅