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>