Touch タスク

  • [アーティクル]

ファイルのアクセス時刻および変更時刻を設定します。

パラメーター

Touch タスクのパラメーターの説明を次の表に示します。

パラメーター 説明
AlwaysCreate 省略可能な Boolean 型のパラメーターです。

true の場合、まだ存在しないファイルが作成されます。
Files 必須の ITaskItem[] 型のパラメーターです。

タッチするファイルのコレクションを指定します。
ForceTouch 省略可能な Boolean 型のパラメーターです。

true の場合、ファイルが読み取り専用でもファイルにタッチします。
Time 省略可能な String 型のパラメーターです。

時刻を指定します。 既定値は現在の時刻 (Now) です。 形式は、Parse メソッドで DateTimeFormatInfo.InvariantInfo を使用して解析可能である必要があります。
TouchedFiles 省略可能な ITaskItem[] 型の出力パラメーターです。

正常にタッチされた項目のコレクションが含まれます。

解説

上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。 これらの追加のパラメーターの一覧とその説明については、「TaskExtension Base Class」を参照してください。

例

次の例では 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>

関連項目