remove() [1/2]

void xtd::io::directory_info::remove ( ) const

overridevirtual

Deletes this xtd::io::directory_info if it is empty.

Exceptions

xtd::unauthorized_access_exception	The directory contains a read-only file.
xtd::io::directory_not_found_exception	The directory described by this xtd::io::directory_info object does not exist or could not be found.
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 the required permission.

Examples

The following example throws an exception if you attempt to delete a directory that is not empty.

#include <xtd/xtd>
 
using namespace xtd;
using namespace xtd::io;
 
class program {
public:
  static auto main() {
    // Specify the directories you want to manipulate.
    directory_info di1(R"(c:\MyDir)");
 
    try {
      // Create the directories.
      di1.create();
      di1.create_subdirectory("temp");
 
      //This operation will not be allowed because there are subdirectories.
      console::write_line("I am about to attempt to delete {0}", di1.name());
      di1.remove();
      console::write_line("The Delete operation was successful, which was unexpected.");
    } catch (const exception&) {
      console::write_line("The Delete operation failed as expected.");
    }
  }
};
 
startup_(program::main);

Remarks

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

Implements xtd::io::file_system_info.

Examples

file_info_move_to.cpp.