Touch (tâche)Touch task

Définit les heures d’accès et de modification des fichiers.Sets the access and modification times of files.

ParamètresParameters

Le tableau ci-dessous décrit les paramètres de la tâche Touch .The following table describes the parameters of the Touch task.

ParamètreParameter DescriptionDescription
AlwaysCreate Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, crée tous les fichiers qui n’existent pas.If true, creates any files that do not already exist.
Files Paramètre ITaskItem[] obligatoire.Required ITaskItem[] parameter.

Spécifie la collection de fichiers à horodater.Specifies the collection of files to touch.
ForceTouch Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, force un horodatage de fichier même si les fichiers sont en lecture seule.If true, forces a file touch even if the files are read-only.
Time Paramètre String facultatif.Optional String parameter.

Spécifie une heure autre que l’heure actuelle.Specifies a time other than the current time. Le format doit être acceptable pour la méthode Parse.The format must be a format that is acceptable to the Parse method.
TouchedFiles Paramètre de sortie ITaskItem[] facultatif.Optional ITaskItem[] output parameter.

Contient la collection d’éléments horodatés.Contains the collection of items that were successfully touched.

NotesRemarks

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui elle-même hérite de la classe Task.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.For a list of these additional parameters and their descriptions, see TaskExtension base class.

ExempleExample

L’exemple suivant utilise la tâche Touch pour modifier les heures d’accès et de modification des fichiers spécifiés dans la collection d’éléments Files, et place la liste de fichiers horodatés dans la collection d’éléments 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>  

Voir aussiSee also

Tâches Tasks
Informations de référence sur les tâchesTask reference