通过

Touch 任务

  • 项目

设置文件的访问和修改时间。

参数

下表描述了 Touch 任务的参数。

参数 说明
AlwaysCreate 可选 Boolean 参数。

如果为 true，将创建任何尚未存在的文件。
Files 必选 ITaskItem[] 参数。

指定要改动的文件集合。
ForceTouch 可选 Boolean 参数。

如果为 true，则即使在文件为只读时也强制改动文件。
Time 可选 String 参数。

指定时间。 默认为当前时间 (Now)。 格式必须可通过使用 DateTimeFormatInfo.InvariantInfo 的 Parse 方法解析。
TouchedFiles 可选的 ITaskItem[] 输出参数。

包含成功改动的项的集合。

备注

除上面列出的参数外，此任务还从 TaskExtension 类继承参数，后者自身继承自 Task 类。 有关这些其他参数的列表及其说明的信息，请参阅 TaskExtension 基类。

示例

以下示例使用 Touch 任务更改在 Files 项集合中指定的文件的访问和修改时间，并将成功改动的文件列表放入 FilesTouched 项集合。

<Project xmlns="http://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>

另请参阅