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 obter mais informações, consulte Como: Inserir trechos de código de IntelliSense.
Programação robusta
As seguintes condições podem causar uma exceção:
O caminho não é válido para um dos seguintes motivos: ela é 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 sequência 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 possuia as permissões requeridas (UnauthorizedAccessException).
Consulte também
Tarefas
Como: Mover um arquivo em Visual Basic
Como: Mover uma coleção de arquivos em Visual Basic
Como: Criar uma cópia de um arquivo no mesmo diretório do Visual Basic
Como: Criar uma cópia de um arquivo em um diretório diferente em Visual Basic