Partilhar via


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

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

Para copiar um ficheiro de texto para outra pasta

  • Use o CopyFile método para copiar um arquivo, especificando um arquivo de origem e o diretório de destino. O overwrite parâmetro permite especificar se os arquivos existentes devem ou não ser substituídos. Os exemplos de código a seguir demonstram como usar CopyFileo .

    ' 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 fazer com que uma exceção seja lançada:

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

  • O sistema não pôde recuperar o caminho absoluto (ArgumentException).

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

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

  • O caminho combinado aponta para um diretório existente (IOException).

  • O arquivo de destino existe e overwrite está definido 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 nome de arquivo ou pasta 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 (OperationCanceledException).

  • ShowUI está definido como True, onUserCancel está definido 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 tem as permissões necessárias para visualizar o caminho (SecurityException).

Consulte também