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>

请参见

概念

MSBuild 任务

其他资源

MSBuild 任务参考