FileSystem.CopyFile Método

Referência

Definição

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

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

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)

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Copia um arquivo para um novo local.

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

public static void CopyFile (string sourceFileName, string destinationFileName);

static member CopyFile : string * string -> unit

Public Shared 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 no Visual Basic
Copie um arquivo para um diretório diferente.	Como criar uma cópia de um arquivo em um diretório diferente no Visual Basic

Confira também

UICancelOption

Aplica-se a

CopyFile(String, String, UIOption)

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Copia um arquivo para um novo local.

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

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

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

Public Shared 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 no Visual Basic
Copie um arquivo para um diretório diferente.	Como criar uma cópia de um arquivo em um diretório diferente no Visual Basic

Confira também

UICancelOption

Aplica-se a

CopyFile(String, String, Boolean)

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Copia um arquivo para um novo local.

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

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

static member CopyFile : string * string * bool -> unit

Public Shared 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 no Visual Basic
Copie um arquivo para um diretório diferente.	Como criar uma cópia de um arquivo em um diretório diferente no Visual Basic

Confira também

UICancelOption

Aplica-se a

CopyFile(String, String, UIOption, UICancelOption)

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Origem:: FileSystem.vb

Copia um arquivo para um novo local.

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

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

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

Public Shared 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 no Visual Basic
Copie um arquivo para um diretório diferente.	Como criar uma cópia de um arquivo em um diretório diferente no Visual Basic

Confira também

UICancelOption

Aplica-se a

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

Comentários

Recursos adicionais