Touch 任务
设置文件的访问和修改时间。
参数
下表描述了 Touch 任务的参数。
Parameter |
说明 |
---|---|
AlwaysCreate |
可选 Boolean 参数。 如果设置为 true,将会创建尚未存在的任何文件。 |
Files |
必选 ITaskItem[] 参数。 指定要使用的文件的集合。 |
ForceTouch |
可选 Boolean 参数。 如果设置为 true,那么即便文件是只读的,也会强制使用文件。 |
Time |
可选 String 参数。 指定当前时间之外的时间。 必须采用 Parse 方法可以接受的格式。 |
TouchedFiles |
可选 ITaskItem[] 输出参数。 包含已成功使用的项的集合。 |
备注
除了上面列出的参数,此任务还将从 TaskExtension 类继承参数,此类本身从 Task 类继承。 有关这些附加参数及其说明的列表,请参见 TaskExtension 基类。
示例
下面的示例使用 Touch 任务更改 Files 项集合中指定的文件的访问和修改时间,并将成功使用的文件的列表放置在 FilesTouched 项集合中。
<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>