move_to()

void xtd::io::directory_info::move_to

(

const xtd::string &

dest_dir_name

)

Moves a DirectoryInfo instance and its contents to a new path.

Parameters

dest_dir_name

The name and path to which to move this directory. The destination cannot be another disk volume or a directory with the identical name. It can be an existing directory to which you want to add this directory as a subdirectory.

Exceptions

xtd::io::directory_not_found_exception	The specified path is invalid, such as being on an unmapped drive.
xtd::io::io_exception	The directory is not empty. -or- The directory is the application's current working directory. -or- There is an open handle on the directory.
xtd::security::security_exception	The caller does not have code access permission to create the directory.

Examples

The following example demonstrates moving a directory.

#include <xtd/xtd>
 
using namespace xtd;
using namespace xtd::io;
 
class program {
public:
  static auto main() {
    // Make a reference to a directory.
    directory_info di("TempDir");
 
    // Create the directory only if it does not already exist.
    if (di.exists() == false)
      di.create();
 
    // Create a subdirectory in the directory just created.
    directory_info dis = di.create_subdirectory("SubDir");
 
    // Move the main directory. Note that the contents move with the directory.
    if (directory::exists("NewTempDir") == false)
      di.move_to("NewTempDir");
 
    try {
      // Attempt to delete the subdirectory. Note that because it has been
      // moved, an exception is thrown.
      dis.remove(true);
    } catch (const exception&) {
      // Handle this exception in some way, such as with the following code:
      // console::write_line("That directory does not exist.");
    }
 
    // Point the directory_info reference to the new directory.
    //di = directory_info("NewTempDir");
 
    // Delete the directory.
    //di.remove(true);
  }
};
 
startup_(program::main);

Remarks

This method throws an IOException if, for example, you try to move c:\mydir to c:, and c:already exists. You must specify "c:\\public\\mydir" as the destDirName parameter, or specify a new directory name such as "c:\\newdir".

This method permits moving a directory to a read-only directory. The read/write attribute of neither directory is affected.

For a list of common I/O tasks, see Common I/O Tasks.