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>