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


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

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

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

' Usage
My.Computer.FileSystem.RenameDirectory(directory ,newName)
' Declaration
Public Sub RenameDirectory( _
   ByVal directory As String, _
   ByVal newName As String _
)

Параметры

  • directory
    String. Имя каталога, который необходимо переименовать, и путь к нему. Обязательный параметр.

  • newName
    String. Новое имя каталога. Обязательный параметр.

Исключения

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

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

  • Параметр newName содержит сведения о пути (ArgumentException).

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

  • Параметр newName содержит значение Nothing или пустую строку (ArgumentNullException).

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

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

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

  • Длина пути превышает 248 знаков (PathTooLongException).

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

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

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

Заметки

Этот метод не позволяет перемещать каталог. Для перемещения каталога с переименованием используйте метод MoveDirectory.

Задачи

В следующей таблице содержится пример задачи, в которой используется метод My.Computer.FileSystem.RenameDirectory.

Задачи

См. разделы

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

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

Пример

В этом примере каталог Test переименовывается в SecondTest.

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

Требования

Пространство имен:Microsoft.VisualBasic.MyServices

Класс:FileSystemProxy (предоставляет доступ к FileSystem)

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта

Доступность

Приложение Windows

Да

Библиотека классов

Да

Консольное приложение

Да

Библиотека элементов управления Windows

Да

Библиотека веб-элементов управления

Да

Служба Windows

Да

Веб-узел

Да

Разрешения

Могут потребоваться следующие разрешения:

Разрешение

Описание

FileIOPermission

Определяет возможность доступа к файлам или папкам. Связанное перечисление: Unrestricted.

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Задачи

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

Ссылки

Объект My.Computer.FileSystem

RenameDirectory

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

Другие ресурсы

Создание, удаление и перемещение файлов и папок в Visual Basic