Compartilhar via


Como mover um arquivo no Visual Basic

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

Mover um arquivo

  • Use o método MoveFile para mover o arquivo, especificando o nome de arquivo e o local tanto para o arquivo de origem quanto para o arquivo de destino. Este exemplo move o arquivo de nome test.txt de TestDir1 para TestDir2. Observe que o nome do arquivo de destino é especificado mesmo que seja igual ao nome do arquivo de origem.

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

Mover um arquivo e renomeá-lo

  • Use o método MoveFile para mover o arquivo, especificando o nome de arquivo e o local, o local de destino e o novo nome no local de destino. Este exemplo move o arquivo de nome test.txt de TestDir1 para TestDir2 e o renomeia como 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 por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).

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

  • destinationFileName é Nothing ou é uma cadeia de caracteres 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á sendo usado ou o usuário não tem 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 está definido como True, onUserCancel está definido como ThrowException e 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 a permissão necessária (UnauthorizedAccessException).

Confira também