Метод 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 |
Да |
Веб-узел |
Да |
Разрешения
Могут потребоваться следующие разрешения:
Разрешение |
Описание |
|---|---|
Определяет возможность доступа к файлам или папкам. Связанное перечисление: Unrestricted. |
Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.
См. также
Задачи
Практическое руководство. Анализ путей к файлам в Visual Basic
Ссылки
Метод My.Computer.FileSystem.MoveDirectory
Другие ресурсы
Создание, удаление и перемещение файлов и папок в Visual Basic