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>

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben

MSBuild-Grundlagen