FindUnderPath-Aufgabe
Ermittelt, welche Elemente in der angegebenen Elementauflistung Pfade in dem angegebenen Ordner oder diesem untergeordnete Pfade aufweisen.
Parameter
In der folgenden Tabelle werden die Parameter der FindUnderPath-Aufgabe beschrieben.
Parameter |
Beschreibung |
---|---|
Files |
Optionaler ITaskItem[]-Parameter. Gibt die Dateien an, deren Pfade mit dem vom Path-Parameter angegebenen Pfad verglichen werden sollen. |
InPath |
Optionaler ITaskItem[]-Ausgabeparameter. Enthält die Elemente, die im angegebenen Pfad gefunden wurden. |
OutOfPath |
Optionaler ITaskItem[]-Ausgabeparameter. Enthält die Elemente, die im angegebenen Pfad nicht gefunden wurden. |
Path |
Erforderlicher ITaskItem-Parameter. Gibt den Ordnerpfad an, auf den verwiesen werden soll. |
UpdateToAbsolutePaths |
Optionaler Boolean-Parameter. Bei true werden die Pfade der Ausgabeelemente in absolute Pfade geändert. |
Hinweise
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der TaskExtension-Klasse, die selbst von der Task-Klasse erbt.Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.
Beispiel
Im folgenden Beispiel wird mithilfe der FindUnderPath-Aufgabe ermittelt, ob die im MyFiles-Element enthaltenen Dateien Pfade aufweisen, die dem von der SearchPath-Eigenschaft angegebenen Pfad untergeordnet sind.Nachdem Abschluss der Aufgabe enthält das FilesNotFoundInPath-Element die Datei File1.txt und das FilesFoundInPath-Element die Datei 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>