Compartilhar via


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

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", _
        FileIO.UIOption.AllDialogs, _
        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", _
        FileIO.UIOption.AllDialogs, _
        FileIO.UICancelOption.DoNothing)
    

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

Consulte também

Tarefas

Como: Copiar arquivos com um padrão específico para um diretório no Visual Basic

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

Como: Copiar um diretório para outro diretório no Visual Basic

Como: Renomear um arquivo no Visual Basic

Referência

Objeto My.Computer.FileSystem

Método My.Computer.FileSystem.CopyFile

Enumeração UICancelOption