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>