Método My.Computer.FileSystem.CopyFile

Artigo
08/25/2010

Copia um arquivo para um novo local.

' Usage
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parâmetros

sourceFileName
String.O arquivo a ser copiado.Obrigatório.
destinationFileName
String.O local ao qual o arquivo deve ser copiado.Obrigatório.
overwrite
Boolean.Se os arquivos existentes devem ser substituídos.O padrão é False.Obrigatório.
showUI
UIOption.Se rastreiem visualmente o progresso da operação.O padrão é UIOption.OnlyErrorDialogs.Obrigatório.
onUserCancel
UICancelOption.Especifica o que deve ser concluído se o usuário clica em Cancelar durante a operação.O padrão é ThrowException.Obrigatório.

Exceções

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).
destinationFileName contém informações de caminho (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
destinationFileName é Nothing ou uma sequência vazia (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 no diretório de destino com o mesmo nome está em uso (IOException).
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).
UICancelOption é definida como ThrowException, e o usuário cancelou a operação (OperationCanceledException).
UICancelOption 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).

Comentários

CopyFile não preserva ACEs (Entradas de Eontrole de Acesso).O arquivo recém-criado herda ACEs padrão do diretório no qual ele é criado.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.CopyFile.

Para	Consulte
Copiar um arquivo para o mesmo diretório	Como: Criar uma Copiar de um arquivo no Diretório mesmo no Visual Basic
Copiar um arquivo para um diretório diferente	Como: Criar uma Copiar de um arquivo em um diretório diferente no Visual Basic

Exemplo

Este exemplo copia o arquivo Test.txt para o diretório TestFiles2 sem substituir arquivos existentes.

My.Computer.FileSystem.CopyFile _
("C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2")

Substitua os caminhos de arquivo pelos caminhos que você deseja usar no seu código.

Este exemplo copia o arquivo Test.txt para o diretório TestFiles2 e o renomeia NewFile.txt.

My.Computer.FileSystem.CopyFile _
("C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2", "NewFile.txt", FileIO.UICancelOption.DoNothing)

Substitua os caminhos de arquivo pelos caminhos que você deseja usar no seu código.

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim

Permissões

As seguintes permissões podem ser necessárias:

Permissão	Descrição
EnvironmentPermission	Controla a capacidade de acessar todas as variáveis de ambiente.Enumeração associada: Unrestricted.
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
RegistryPermission	Controla a capacidade de acessar as variáveis de registro.Enumeração associada: Unrestricted.
UIPermission	Controla as permissões relacionadas às interfaces com o usuário e área de transferência.Enumeração associada: SafeSubWindows.