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>

另請參閱