Moves a file, a directory, or set of files to a new file or directory.

Files are only moved if the source file is newer than the destination file, or if the destination file does not exist. However, you can explicitly overwrite files with the NAnt.Core.Tasks.CopyTask.Overwrite attribute.

A NAnt.Core.Types.FileSet can be used to select files to move. To use a NAnt.Core.Types.FileSet, the NAnt.Core.Tasks.CopyTask.ToDirectory attribute must be set.

Encoding

Unless an encoding is specified, the encoding associated with the system's current ANSI code page is used.

An UTF-8, little-endian Unicode, and big-endian Unicode encoded text file is automatically recognized, if the file starts with the appropriate byte order marks.

If you employ filters in your move operation, you should limit the move to text files. Binary files will be corrupted by the move operation.

Parameters

Attribute	Type	Description	Required
flatten	bool	Ignore directory structure of source directory, move all files into a single directory, specified by the `NAnt.Core.Tasks.MoveTask.ToDirectory` attribute. The default is `false`.	False
file	file	The file to move.	False
todir	directory	The directory to move to.	False
tofile	file	The file to move to.	False
failonerror	bool	Determines if task failure stops the build, or is just reported. The default is `true`.	False
flatten	bool	Ignore directory structure of source directory, copy all files into a single directory, specified by the `NAnt.Core.Tasks.CopyTask.ToDirectory` attribute. The default is `false`.	False
if	bool	If `true` then the task will be executed; otherwise, skipped. The default is `true`.	False
includeemptydirs	bool	Copy any empty directories included in the `NAnt.Core.Types.FileSet`. The default is `true`.	False
inputencoding		The encoding to use when reading files. The default is the system's current ANSI code page.	False
outputencoding		The encoding to use when writing the files. The default is the encoding of the input file.	False
overwrite	bool	Overwrite existing files even if the destination files are newer. The default is `false`.	False
file	file	The file to copy.	False
todir	directory	The directory to copy to.	False
tofile	file	The file to copy to.	False
unless	bool	Opposite of `NAnt.Core.Task.IfDefined`. If `false` then the task will be executed; otherwise, skipped. The default is `false`.	False
verbose	bool	Determines whether the task should report detailed build log messages. The default is `false`.	False

Examples

Move a single file while changing its encoding from "latin1" to "utf-8".

<move
file="myfile.txt"
tofile="mycopy.txt"
inputencoding="latin1"
outputencoding="utf-8" />

Move a set of files.

    <move todir="${build.dir}">
    <fileset basedir="bin">
        <include name="*.dll" />
    </fileset>
</move>

Move a set of files to a directory, replacing @TITLE@ with "Foo Bar" in all files.

    <move todir="../backup/dir">
    <fileset basedir="src_dir">
        <include name="**/*" />
    </fileset>
    <filterchain>
        <replacetokens>
            <token key="TITLE" value="Foo Bar" />
        </replacetokens>
    </filterchain>
</move>

Move an entire directory and its contents.

    <move tofile="target/dir">
  <fileset basedir="source/dir"/>
</move>

Requirements

Assembly: NAnt.Core.dll
Namespace: NAnt.Core.Tasks

<move>

Encoding

Parameters

Nested elements

<fileset>

</fileset>

<filterchain>

</filterchain>

Examples

Requirements