IFileSystemEntity's moveTo and copyTo Functions

The IFileSystemEntity class provides functions that copy or move a file or directory into a specified destination directory:

• The copyTo function copies an entity from its current location to another location
• The moveTo function moves an entity from its current location to another location

These functions are not meant to be customized.

Mover and Copier Classes

The File System Framework provides the following classes which you can subclass if you need customized copy or move behavior:

• IFileOperation is an abstract base class for classes that operate recursively over a tree of file system entities. It is the parent of IFileSystemMover and IFileSystemCopier.
• IFileSystemMover moves files and directories from one IDirectory instance to another, recursively moving all of an entity's children.
• IFileSystemCopier copies files and directories between IDirectory instances, recursively copying all of an entity's children.

These classes provide the infrastructure for progress indicators, custom failure handling, and resolution of file-naming conflicts. You can instantiate and use IFileSystemMover and IFileSystemCopier directly, or subclass them in order to implement progress reporting, name-conflict resolution and failure handling. You can derive from IFileSystemCopier or IFileSystemMover to handle failures, resolve name conflicts, or report progress. You can also create an entirely new file operation by subclassing from IFileOperation. For example, you could create a subclass of IFileOperation that adds up the total size of all files in a directory tree, or searches through all of the files for a particular piece of data.

Introduction to the File System
Overview of File System Entities
File System Exceptions

Copying a File or Directory Using IFileSystemEntity::copyTo
Moving a File or Directory Using IFileSystemEntity::moveTo
Using the IFileSystemCopier and IFileSystemMover Classes Directly
Supporting Progress Indicators
Resolving Filename Conflicts
Handling Exceptions and Other Failures
Creating Your Own File System Operation