Função FileCopy

Artigo
08/25/2010

Copia um arquivo.

O recurso Objeto My.Computer.FileSystem dá a você maior produtividade e desempenho em operações no arquivo I/O que o FileCopy.Consulte Método My.Computer.FileSystem.CopyFile para obter mais informações.

Public Sub FileCopy( _
   ByVal Source As String, _
   ByVal Destination As String _
)

Parâmetros

Source
Obrigatório.String expressão que especifica o nome do arquivo a ser copiado. Source pode incluir o diretório ou pasta e unidade, do arquivo de fonte.
Destination
Obrigatório.String expressão que especifica nome de arquivo de destino. Destination pode incluir o diretório ou pasta e unidade, do arquivo de destino.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	52	Source ou Destination é inválido ou não especificado.
IOException	55	Arquivo já está aberto.
FileNotFoundException	53	Arquivo não existe.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Se você tentar usar a função FileCopy em um arquivo aberto, ocorrerá um erro.

FileCopy requer confiança total para trabalhar na unidade local.

Exemplo

Este exemplo usa a função FileCopy para copiar um arquivo para outro.Para fins deste exemplo, presuma que SrcFile é um arquivo que contém alguns dados.

Dim SourceFile, DestinationFile As String
SourceFile = "SRCFILE"   ' Define source file name.
DestinationFile = "DESTFILE"   ' Define target file name.
FileCopy(SourceFile, DestinationFile)   ' Copy source to target.