FileSystemProxy.CopyFile Método

Definição

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.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

Nome	Description
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 é ou uma Nothing 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á em uso.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

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

SecurityException

O usuário não tem 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

CopyFile nã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	Veja
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 um diretório diferente

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 deseja acompanhar visualmente o progresso da operação. O padrão é UIOption.OnlyErrorDialogs.

Exceções

ArgumentException

destinationFileName contém informações de caminho.

ArgumentNullException

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

FileNotFoundException

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

IOException

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

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

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

SecurityException

O usuário não tem 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

CopyFile nã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	Veja
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 um diretório diferente

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 é ou uma Nothing cadeia de caracteres vazia.

FileNotFoundException

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

IOException

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

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

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

SecurityException

O usuário não tem 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

CopyFile nã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	Veja
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 um diretório diferente

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 deseja acompanhar visualmente o progresso da operação. 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 é ou uma Nothing cadeia de caracteres vazia.

FileNotFoundException

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

IOException

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

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

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

SecurityException

O usuário não tem 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

CopyFile nã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	Veja
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 um diretório diferente

Confira também

Aplica-se a

Comentários

Esta página foi útil?