Compartilhar via


Tarefa FindUnderPath

Determina quais itens na coleção de itens especificados têm caminhos que estão dentro ou abaixo da pasta especificada.

Parâmetros

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

Parâmetro Descrição
Files Parâmetro opcional ITaskItem[].

Especifica os arquivos cujos caminhos devem ser comparados com o caminho especificado pelo parâmetro Path.
InPath Parâmetro de saída ITaskItem[] opcional.

Contém os itens que foram encontrados no caminho especificado.
OutOfPath Parâmetro de saída ITaskItem[] opcional.

Contém os itens que não foram encontrados no caminho especificado.
Path Parâmetro ITaskItem obrigatório.

Especifica o caminho da pasta a ser usada como referência.
UpdateToAbsolutePaths Parâmetro Boolean opcional.

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

Comentários

Além dos parâmetros listados acima, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task. Para obter uma lista desses parâmetros adicionais e suas descrições, confira Classe base TaskExtension.

Exemplo

O exemplo a seguir usa a tarefa FindUnderPath para determinar se os arquivos contidos no item MyFiles têm caminhos existentes no caminho especificado pela propriedade SearchPath. Depois que a tarefa for concluída, o item FilesNotFoundInPath conterá o arquivo File1.txt e o item FilesFoundInPath conterá o arquivo 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>

Confira também