Compartilhar via


FileSystem.CopyFile Método

Definição

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

destinationFileName contém informações de caminho.

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

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

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

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

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

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

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

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

destinationFileName contém informações de caminho.

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

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

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

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

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

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

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

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

destinationFileName contém informações de caminho.

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

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

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

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

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

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

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

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

destinationFileName contém informações de caminho.

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

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

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

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

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

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

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

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

Aplica-se a