Touch タスクTouch Task

ファイルのアクセス時刻および変更時刻を設定します。Sets the access and modification times of files.

パラメーターParameters

Touch タスクのパラメーターの説明を次の表に示します。The following table describes the parameters of the Touch task.

パラメーターParameter 説明Description
AlwaysCreate 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、まだ存在しないファイルが作成されます。If true, creates any files that do not already exist.
Files 必須の ITaskItem[] 型のパラメーターです。Required ITaskItem[] parameter.

タッチするファイルのコレクションを指定します。Specifies the collection of files to touch.
ForceTouch 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、ファイルが読み取り専用でもファイルにタッチします。If true, forces a file touch even if the files are read-only.
Time 省略可能な String 型のパラメーターです。Optional String parameter.

現在の時刻以外の時刻を指定します。Specifies a time other than the current time. Parse メソッドで有効な形式で指定する必要があります。The format must be a format that is acceptable to the Parse method.
TouchedFiles 省略可能な ITaskItem[] 型の出力パラメーターです。Optional ITaskItem[] output parameter.

正常にタッチされた項目のコレクションが含まれます。Contains the collection of items that were successfully touched.

コメントRemarks

上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. これらの追加のパラメーターの一覧とその説明については、「 TaskExtension Base Class」を参照してください。For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

Example

次の例では Touch タスクを使用して、Files 項目コレクションに指定されたファイルのアクセス時刻および更新時刻を変更し、FilesTouched 項目コレクションに正常にタッチされたファイルのリストを配置しています。The following example uses the Touch task to change the access and modification times of the files specified in the Files item collection, and puts the list of successfully touched files in the FilesTouched item collection.

<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>  

関連項目See Also

タスク Tasks
Task Reference (タスク リファレンス)Task Reference