Como: renomear um arquivo em Visual Basic

Use o método RenameFile do objeto My.Computer.FileSystem para renomear um arquivo fornecendo o local atual, nome do arquivo e o novo nome de arquivo.Este método não pode ser usado para mover um arquivo; use o método MoveFile para mover e renomear o arquivo.

Para renomear um arquivo

  • Use o método My.Computer.FileSystem.RenameFile Para renomear um arquivo.Este exemplo renomeia o arquivo Test.txt para SecondTest.txt.

    ' Change "c:\test.txt" to the path and filename for the file that
    ' you want to rename.
    My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
    

Este exemplo de código também está disponível como um trecho de código IntelliSense.No selecionador de trecho de código, o trecho está localizado em File system - Processing Drives, Folders, and Files.Para mais informações, consulte Trechos de código.

Programação robusta

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

  • O caminho não é válido para uma das seguintes razões: ele é uma seqüência 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).

  • newName contém informações de caminho (ArgumentException).

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

  • newName é Nothing ou uma cadeia de caracteres vazia (ArgumentNullException).

  • O arquivo de origem não é válido ou não existe (FileNotFoundException).

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

  • O caminho excede o comprimento máximo definido pelo sistema (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 a permissão necessária (UnauthorizedAccessException).

Consulte também

Tarefas

Como: mover um arquivo em Visual Basic

Como: criar uma cópia de um arquivo no mesmo diretório em Visual Basic

Como: criar uma cópia de um arquivo em um diretório diferente em Visual Basic

Referência

RenameFile

Outros recursos

Criação, exclusão e movimentação de arquivos e diretórios em Visual Basic