Como: Mover um arquivo em Visual Basic

O método My.Computer.FileSystem.MoveFile pode ser usado para mover um arquivo para outra pasta. Se a estrutura de destino não existir, será criada.

Para mover um arquivo

  • Use o método MoveFile para mover o arquivo, especificando o nome do arquivo e o local para o arquivo de origem e para o arquivo de destino. Este exemplo move o arquivo chamado test.txt a partir de TestDir1 para TestDir2. Observe que o nome do arquivo de destino é especificado mesmo que for o mesmo nome que o nome do arquivo de origem.

    My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt",
        "C:\TestDir2\test.txt")
    

Para mover um arquivo e renomeá-lo.

  • Use o método MoveFile para mover o arquivo, especificando o nome e o local do arquivo de origem, a localização de destino, e o novo nome no local de destino. Este exemplo move o arquivo chamado test.txt a partir de TestDir1 para TestDir2 e o renomeia para nexttest.txt.

    My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt",
        "C:\TestDir2\nexttest.txt",
        FileIO.UIOption.AllDialogs,
        FileIO.UICancelOption.ThrowException)
    

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).

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

  • destinationFileName é Nothing ou uma sequência vazia (ArgumentNullException).

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

  • O caminho combinado aponta para um diretório existente, o arquivo de destino existe e overwrite é definido como False, um arquivo no diretório de destino com o mesmo nome está em uso, ou o usuário não possui permissões suficientes para acessar o arquivo (IOException).

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

  • showUIé definido como True, onUserCancelé definida como ThrowExceptione o usuário cancelou a operação ou ocorre um erro de e/S não especificado (OperationCanceledException).

  • O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).

  • 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).

Consulte também

Tarefas

Como: Renomear um arquivo em Visual Basic

Como: Mover uma coleção de arquivos em Visual Basic

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

Como: Analisar os caminhos de arquivo em Visual Basic

Como: Move um diretório de Visual Basic

Referência

MoveFile