Partilhar via

Como: Renomear um arquivo no Visual Basic

  • Artigo

No Visual Basic, há duas maneiras de renomear um arquivo. Você pode usar o objeto My.Computer.FileSystem de tempo de execução do Visual Basic ou o objeto fornecido System.IO.File pelo .NET para renomear um arquivo.

Renomear com .NET

O System.IO.File objeto não contém um método para renomear um arquivo, em vez disso, use o Move método para "mover" o arquivo para o mesmo local, mas com um nome de arquivo diferente. Esse método também pode ser usado para mover o arquivo para um local diferente com um nome diferente, executando uma movimentação e renomear juntos.

O exemplo a seguir renomeia o arquivo localizado na My Documents pasta de TextFile.txt para NewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePathSource = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")
Dim filePathTarget = System.IO.Path.Combine(myDocsFolder, "NewName.txt")

System.IO.File.Move(filePathSource, filePathTarget)

Renomear com o tempo de execução do Visual Basic

Use o RenameFile método do objeto para renomear um arquivo fornecendo o caminho completo para o arquivo e o novo nome de My.Computer.FileSystem arquivo. Esse método não pode ser usado para mover um arquivo para um diretório diferente. Para saber como mover um arquivo, consulte Como mover um arquivo no Visual Basic.

O exemplo a seguir renomeia o arquivo localizado na My Documents pasta de TextFile.txt para NewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePath = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")

My.Computer.FileSystem.RenameFile(filePath, "NewName.txt")

O Visual Studio fornece um trecho de código do IntelliSense que usa My.Computer.FileSystem.RenameFileo . O trecho está localizado em Sistema de arquivos - Unidades de processamento, pastas e arquivos. Para obter 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 por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco, 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 é 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 diretório no caminho contém dois pontos (:) ou está em um formato inválido (NotSupportedException).
  • O usuário não tem as permissões necessárias para visualizar o caminho (SecurityException).
  • O usuário não tem a permissão necessária (UnauthorizedAccessException).

Consulte também