Partager via


FindUnderPath, tâche

Détermine les éléments de la collection d'éléments spécifiée dont les chemins d'accès figurent dans le dossier spécifié ou sous celui-ci.

Paramètres

Le tableau suivant décrit les paramètres de la tâche FindUnderPath.

Paramètre

Description

Files

Paramètre ITaskItem[] optionnel.

Spécifie les fichiers dont les chemins d'accès doivent être comparés au chemin d'accès spécifié par le paramètre Path.

InPath

Paramètre de sortie ITaskItem[] facultatif.

Contient les éléments trouvés sous le chemin d'accès spécifié.

OutOfPath

Paramètre de sortie ITaskItem[] facultatif.

Contient les éléments introuvables sous le chemin d'accès spécifié.

Path

Paramètre ITaskItem obligatoire.

Spécifie le chemin d'accès au dossier à utiliser comme référence.

UpdateToAbsolutePaths

Paramètre Boolean facultatif.

Si la valeur est true, les chemins d'accès des éléments de sortie sont mis à jour pour correspondre à des chemins absolus.

Notes

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui hérite elle-même de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez Classe TaskExtension Base.

Exemple

L'exemple suivant utilise la tâche FindUnderPath pour déterminer si les fichiers contenus dans l'élément MyFiles possèdent des chemins d'accès sous le chemin d'accès spécifié par la propriété SearchPath. Au terme de la tâche, l'élément FilesNotFoundInPath contient le fichier File1.txt et l'élément FilesFoundInPath contient le fichier File2.txt.

<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>

Voir aussi

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild

Concepts MSBuild