FileSystemProxy.CopyFile Método

Referência

Definição

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Copia um arquivo para um novo local.

Sobrecargas

CopyFile(String, String)	Copia um arquivo para um novo local.
CopyFile(String, String, UIOption)	Copia um arquivo para um novo local.
CopyFile(String, String, Boolean)	Copia um arquivo para um novo local.
CopyFile(String, String, UIOption, UICancelOption)	Copia um arquivo para um novo local.

CopyFile(String, String)

Copia um arquivo para um novo local.

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public void CopyFile (string sourceFileName, string destinationFileName);

member this.CopyFile : string * string -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String)

Parâmetros

sourceFileName: String

O arquivo a ser copiado.

destinationFileName: String

O local para o qual o arquivo deve ser copiado.

Exceções

ArgumentException

destinationFileName contém informações de caminho.

ArgumentNullException

destinationFileName ou sourceFileName é Nothing ou uma cadeia de caracteres vazia.

FileNotFoundException

O arquivo de origem não é válido ou não existe.

IOException

Um arquivo no diretório de destino com o mesmo nome está sendo usado.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

UnauthorizedAccessException

O usuário não tem a permissão necessária.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

Exemplos

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\test.txt", overwrite:=False)

Substitua os caminhos de arquivo pelos caminhos que você deseja usar em 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.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

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

Comentários

CopyFilenão preserva ACEs (entradas de Controle de Acesso). O arquivo recém-criado herda ACEs padrão do diretório no qual ele é criado.

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

Para	Consulte
Copie um arquivo para o mesmo diretório.	Como: criar uma cópia de um arquivo no mesmo diretório
Copie um arquivo para um diretório diferente.	Como: criar uma cópia de um arquivo em outro diretório

Confira também

Aplica-se a

CopyFile(String, String, UIOption)

Copia um arquivo para um novo local.

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Parâmetros

sourceFileName: String

O arquivo a ser copiado.

destinationFileName: String

O local para o qual o arquivo deve ser copiado.

showUI: UIOption

Se o progresso da operação deve ser acompanhado visualmente. O padrão é UIOption.OnlyErrorDialogs.

Exceções

ArgumentException

destinationFileName contém informações de caminho.

ArgumentNullException

destinationFileName ou sourceFileName é Nothing ou uma cadeia de caracteres vazia.

FileNotFoundException

O arquivo de origem não é válido ou não existe.

IOException

O arquivo de destino já existe e overwrite é definido como False.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

UnauthorizedAccessException

O usuário não tem a permissão necessária.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

Exemplos

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\test.txt", overwrite:=False)

Substitua os caminhos de arquivo pelos caminhos que você deseja usar em 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.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

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

Comentários

CopyFilenão preserva ACEs (entradas de Controle de Acesso). O arquivo recém-criado herda ACEs padrão do diretório no qual ele é criado.

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

Para	Consulte
Copie um arquivo para o mesmo diretório.	Como: criar uma cópia de um arquivo no mesmo diretório
Copie um arquivo para um diretório diferente.	Como: criar uma cópia de um arquivo em outro diretório

Confira também

Aplica-se a

CopyFile(String, String, Boolean)

Copia um arquivo para um novo local.

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public void CopyFile (string sourceFileName, string destinationFileName, bool overwrite);

member this.CopyFile : string * string * bool -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Parâmetros

sourceFileName: String

O arquivo a ser copiado.

destinationFileName: String

O local para o qual o arquivo deve ser copiado.

overwrite: Boolean

True se os arquivos existentes devem ser substituídos; caso contrário, False. O padrão é False.

Exceções

ArgumentException

destinationFileName contém informações de caminho.

ArgumentNullException

destinationFileName ou sourceFileName é Nothing ou uma cadeia de caracteres vazia.

FileNotFoundException

O arquivo de origem não é válido ou não existe.

IOException

O arquivo de destino já existe e overwrite é definido como False.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

UnauthorizedAccessException

O usuário não tem a permissão necessária.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

Exemplos

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\test.txt", overwrite:=False)

Substitua os caminhos de arquivo pelos caminhos que você deseja usar em 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.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

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

Comentários

CopyFilenão preserva ACEs (entradas de Controle de Acesso). O arquivo recém-criado herda ACEs padrão do diretório no qual ele é criado.

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

Para	Consulte
Copie um arquivo para o mesmo diretório.	Como: criar uma cópia de um arquivo no mesmo diretório
Copie um arquivo para um diretório diferente.	Como: criar uma cópia de um arquivo em outro diretório

Confira também

Aplica-se a

CopyFile(String, String, UIOption, UICancelOption)

Copia um arquivo para um novo local.

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parâmetros

sourceFileName: String

O arquivo a ser copiado.

destinationFileName: String

O local para o qual o arquivo deve ser copiado.

showUI: UIOption

Se o progresso da operação deve ser acompanhado visualmente. O padrão é UIOption.OnlyErrorDialogs.

onUserCancel: UICancelOption

Especifica o que deve ser feito se o usuário clicar em Cancelar durante a operação. O padrão é ThrowException.

Exceções

ArgumentException

destinationFileName contém informações de caminho.

ArgumentNullException

destinationFileName ou sourceFileName é Nothing ou uma cadeia de caracteres vazia.

FileNotFoundException

O arquivo de origem não é válido ou não existe.

IOException

O arquivo de destino já existe e overwrite é definido como False.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

UnauthorizedAccessException

O usuário não tem a permissão necessária.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

OperationCanceledException

UICancelOption é definido como ThrowException e o usuário cancelou a operação ou ocorre um erro de E/S não especificado.

Exemplos

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\test.txt", overwrite:=False)

Substitua os caminhos de arquivo pelos caminhos que você deseja usar em 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.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

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

Comentários

CopyFilenão preserva ACEs (entradas de Controle de Acesso). O arquivo recém-criado herda ACEs padrão do diretório no qual ele é criado.

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

Para	Consulte
Copie um arquivo para o mesmo diretório.	Como: criar uma cópia de um arquivo no mesmo diretório
Copie um arquivo para um diretório diferente.	Como: criar uma cópia de um arquivo em outro diretório

Confira também

Aplica-se a

Compartilhar via

FileSystemProxy.CopyFile Método

Definição

Sobrecargas

CopyFile(String, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

CopyFile(String, String, UIOption)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

CopyFile(String, String, Boolean)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

CopyFile(String, String, UIOption, UICancelOption)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais