Freigeben über


Touch-Aufgabe

Legt die Zugriffs- und die Änderungszeiten für Dateien fest.

Parameter

In der folgenden Tabelle werden die Parameter der Touch-Aufgabe beschrieben.

Parameter

Beschreibung

AlwaysCreate

Optionaler Boolean-Parameter.

Wenn der Wert true lautet, werden Dateien, die noch nicht vorhanden sind, erstellt.

Files

Erforderlicher ITaskItem[]-Parameter.

Gibt die Auflistung der zu ändernden Dateien an.

ForceTouch

Optionaler Boolean-Parameter.

Wenn der Wert true lautet, wird die Änderung der Dateien erzwungen, auch wenn die Dateien schreibgeschützt sind.

Time

Optionaler String-Parameter.

Gibt eine andere als die aktuelle Zeit an. Die Angabe muss in einem für die Parse-Methode zulässigen Format vorliegen.

TouchedFiles

Optionaler ITaskItem[]-Ausgabeparameter.

Enthält die Auflistung der Elemente, die erfolgreich aktualisiert wurden.

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 die Touch-Aufgabe verwendet, um die Zugriffs- und Änderungszeiten der in der Files-Elementauflistung angegebenen Dateien zu ändern. Die Liste der Dateien, die erfolgreich aktualisiert wurden, wird in der FilesTouched-Elementauflistung gespeichert.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">

<ItemGroup>
    <Files Include="File1.cs;File2.cs;File3.cs" />
</ItemGroup>

    <Target Name="TouchFiles">
        <Touch
            Files="@(Files)">
            <Output
                TaskParameter="TouchedFiles"
                ItemName="FilesTouched"/>
    </Touch>
</Target>
</Project>

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben