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 필수 <xref:Microsoft.Build.Framework.ITaskItem>[] 매개 변수입니다.Required <xref:Microsoft.Build.Framework.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. 형식이 <xref:System.DateTime.Parse%2A> 메서드에 사용할 수 있는 형식이어야 합니다.The format must be a format that is acceptable to the <xref:System.DateTime.Parse%2A> method.
TouchedFiles 선택적 <xref:Microsoft.Build.Framework.ITaskItem>[] 출력 매개 변수입니다.Optional <xref:Microsoft.Build.Framework.ITaskItem>[] output parameter.

성공적으로 터치한 항목 컬렉션을 포함합니다.Contains the collection of items that were successfully touched.

설명Remarks

이 작업은 위에 나와 있는 매개 변수 외에 <xref:Microsoft.Build.Utilities.Task> 클래스에서 직접 상속하는 <xref:Microsoft.Build.Tasks.TaskExtension> 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the <xref:Microsoft.Build.Tasks.TaskExtension> class, which itself inherits from the <xref:Microsoft.Build.Utilities.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