Touch 工作
設定檔案的存取和修改時間。
參數
下表說明 Touch 工作的參數。
參數 |
描述 |
|---|---|
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>