Compartilhar via


Tarefa FindUnderPath

Determina quais itens na coleção item especificado têm caminhos que estão em ou abaixo da pasta especificada.

Parâmetros

A tabela a seguir descreve os parâmetros do FindUnderPath tarefa.

Parâmetro

Descrição

Files

Opcional ITaskItem[] parâmetro.

Especifica os arquivos cujos caminhos devem ser comparados com o caminho especificado pelo Path parâmetro.

InPath

Opcional ITaskItem[] parâmetro de saída.

Contém os itens que foram encontrados no caminho especificado.

OutOfPath

Opcional ITaskItem[] parâmetro de saída.

Contém os itens que não foram encontrados no caminho especificado.

Path

Obrigatório ITaskItem parâmetro.

Especifica o caminho de pasta para usar como referência.

UpdateToAbsolutePaths

Opcional Boolean parâmetro.

Se verdadeiro, os caminhos dos itens de saída são atualizados para ser caminhos absolutos.

Comentários

Além para os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension classe, que herda de Task classe.Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base TaskExtension.

Exemplo

O exemplo a seguir usa o FindUnderPath tarefas para determinar se os arquivos continham na MyFiles item têm caminhos que existe no caminho especificado pelo SearchPath propriedade.Após a conclusão da tarefa, o FilesNotFoundInPath item contém o File1.txt arquivo e o FilesFoundInPath item contém o File2.txt arquivo.

<Project xmlns="https://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>

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild

Conceitos do MSBuild