Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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>