Compartilhar via


Como: Mover um arquivo no 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 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 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 ThrowException, e o usuário cancelou a operação ou um erro não especificado de E/S ocorrerá (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 no Visual Basic

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

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

Como: Analisar arquivo Paths in Visual Basic

Como: Mover um diretório no Visual Basic

Referência

Método My.Computador.FileSystem.MoveFile