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

Artigo
08/01/2011

O método My.Computer.FileSystem.CopyFile permite que você copie arquivos. Seus parâmetros fornecem a capacidade de sobrescrever arquivos existentes, renomiar o arquivo, mostrar o andamento da operação e permitir que o usuário cancele a operação.

Para copiar um arquivo de texto para outra pasta

Use o método CopyFile para copiar um arquivo, especificando um arquivo de origem e o diretório de destino. O parâmetro overwrite permite que você especifique se deseja ou não substituir arquivos existentes. Os exemplos de código a seguir demonstram como usar CopyFile.

' Copy the file to a new location without overwriting existing file.
My.Computer.FileSystem.CopyFile(
    "C:\UserFiles\TestFiles\testFile.txt",
    "C:\UserFiles\TestFiles2\testFile.txt")

' Copy the file to a new folder, overwriting existing file.
My.Computer.FileSystem.CopyFile(
    "C:\UserFiles\TestFiles\testFile.txt",
    "C:\UserFiles\TestFiles2\testFile.txt",
    Microsoft.VisualBasic.FileIO.UIOption.AllDialogs,
    Microsoft.VisualBasic.FileIO.UICancelOption.DoNothing)

' Copy the file to a new folder and rename it.
My.Computer.FileSystem.CopyFile(
    "C:\UserFiles\TestFiles\testFile.txt",
    "C:\UserFiles\TestFiles2\NewFile.txt",
    Microsoft.VisualBasic.FileIO.UIOption.AllDialogs,
    Microsoft.VisualBasic.FileIO.UICancelOption.DoNothing)

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 sistema não pôde recuperar o caminho absoluto (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
O arquivo de origem não é válido ou não existe (FileNotFoundException).
O caminho combinado aponta para uma pasta existente (IOException).
O arquivo de destino existe e overwrite é definida como False (IOException).
O usuário não tem permissões suficientes para acessar o arquivo (IOException).
Um arquivo na pasta de destino com o mesmo nome está em uso (IOException).
Um arquivo ou nome da pasta no caminho contém dois-pontos (:) ou está em formato inválido (NotSupportedException).
ShowUI está definida como True, (onUserCancel) está definida como ThrowException, e o usuário cancelou a operação (OperationCanceledException).
ShowUI está definida como True, onUserCancel está definida como ThrowException, e 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 tem permissão necessária (UnauthorizedAccessException).
O usuário não possui permissões necessárias para exibir o caminho (SecurityException).