Partilhar via


Tarefa de 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 da FindUnderPath de tarefas.

Parâmetro

Descrição

Files

Opcional ITaskItem[] parâmetro.

Especifica os arquivos cujos caminhos devem ser comparados com o caminho especificado pela 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 de para os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension , a própria classe herda o Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base de TaskExtension.

Exemplo

O exemplo a seguir usa a FindUnderPath tarefas para determinar se os arquivos continham no MyFiles item têm caminhos que existem no caminho especificado pelo SearchPath propriedade. Após a conclusão da tarefa, o FilesNotFoundInPath item contém a File1.txt o arquivo e o FilesFoundInPath item contém a 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

MSBuild Concepts