Compartilhar via


Método My.Computer.FileSystem.FindInFiles

Renomeia um Diretório.

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

Parâmetros

  • directory
    String.Caminho e o nome do diretório a ser renomeado.Obrigatório.

  • newName
    String.Novo nome para o diretório.Obrigatório.

Exceções

As seguintes condições podem causar uma exceção:

  • O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).

  • O parâmetro newName contém informações de caminho (ArgumentException).

  • O caminho não é válido porque ele é Nothing (ArgumentNullException).

  • O parâmetro newName é Nothing ou uma sequência de caracteres vazia (ArgumentNullException).

  • O diretório de origem não é válido ou não existe (DirectoryNotFoundException).

  • Há um arquivo ou diretório existente com o nome especificado em newName (IOException).

  • O diretório é um diretório raiz (IOException).

  • O caminho excede 248 caracteres (PathTooLongException).

  • Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).

  • O usuário não possui permissões necessárias para exibir o caminho (SecurityException).

  • O usuário não tem permissão necessária (UnauthorizedAccessException).

Comentários

Este método não pode ser usado para mover um diretório; use o método MoveDirectory para mover e renomear o diretório.

Tarefas

A tabela seguinte lista um exemplo de tarefa envolvendo o método My.Computer.FileSystem.RenameDirectory.

Para

Consulte

Renomear um Diretório.

Como: Renomear um diretório no Visual Basic

Exemplo

Este exemplo renomeia o diretório Test para SecondTest.

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

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto

Disponível

Aplicativo do Windows

Sim

Biblioteca de Classe

Sim

Aplicativo de Console

Sim

Biblioteca de Controle do Windows

Sim

Biblioteca de Controle da Web

Sim

Serviço do Windows

Sim

Site

Sim

Permissões

A permissão a seguir pode ser necessária:

Permissão

Descrição

FileIOPermission

Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Tarefas

Como: Analisar Arquivo Paths in Visual Basic

Referência

Objeto My.Computer.FileSystem

RenameDirectory

Método My.Computer.FileSystem.MoveDirectory

Outros recursos

Criar, excluir e mover arquivos e pastas em Visual Basic