Поделиться через


Практическое руководство. Переименование каталога в Visual Basic

Обновлен: Ноябрь 2007

Для переименования каталога можно использовать метод RenameDirectory объекта My.Computer.FileSystem, указав текущее расположение и имя каталога, а также новое имя для каталога. Этот метод не позволяет перемещать каталог; для перемещения каталога с переименованием используйте метод MoveDirectory.

Переименование каталога

  • Для переименования каталога используйте метод My.Computer.FileSystem.RenameDirectory. Следующий код переименовывает каталог Test в SecondTest.

    My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", _
    "SecondTest")
    

Данный пример кода доступен также в качестве фрагмента кода IntelliSense. В выборе фрагменте кода пример находится в разделе Файловая система — Обработка дисков, папок и файлов. Дополнительные сведения см. в разделе Практическое руководство. Вставка фрагментов в код (Visual Basic).

Отказоустойчивость

Исключение может возникнуть при следующих условиях.

  • Путь является недопустимым, поскольку путь представляет собой строку нулевой длины (пустую строку), либо содержит только пробелы, либо содержит недопустимые знаки, либо представляет собой путь к устройству (начинается с \\.\) (ArgumentException).

  • newName содержит информацию о пути (ArgumentException).

  • Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).

  • Параметр newName равен Nothing или является пустой строкой (ArgumentNullException).

  • Исходный каталог не является допустимым или не существует (DirectoryNotFoundException).

  • Имеется существующий файл или каталог с именем, указанным в newName (IOException).

  • Каталог является корневым (IOException).

  • Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).

  • Имя файла или папки в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).

  • У пользователя отсутствуют необходимые разрешения на просмотр пути (SecurityException).

  • Пользователь не имеет необходимого разрешения (UnauthorizedAccessException).

См. также

Задачи

Практическое руководство. Копирование каталога в другой каталог в Visual Basic

Практическое руководство. Анализ путей к файлам в Visual Basic

Практическое руководство. Перемещение каталога в Visual Basic

Практическое руководство. Перемещение содержимого каталога в Visual Basic

Ссылки

Метод My.Computer.FileSystem.RenameDirectory