FileSystem.CopyFile Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic.FileIO

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Copia um ficheiro para um novo local.

Sobrecargas

Name	Description
CopyFile(String, String)	Copia um ficheiro para um novo local.
CopyFile(String, String, UIOption)	Copia um ficheiro para um novo local.
CopyFile(String, String, Boolean)	Copia um ficheiro para um novo local.
CopyFile(String, String, UIOption, UICancelOption)	Copia um ficheiro para um novo local.

CopyFile(String, String)

Copia um ficheiro 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 ficheiro a ser copiado.

destinationFileName: String

O local para onde o ficheiro deve ser copiado.

Exceções

ArgumentException

destinationFileName contém informação de caminho.

ArgumentNullException

destinationFileName ou sourceFileName é Nothing ou uma corda vazia.

FileNotFoundException

O ficheiro fonte não é válido ou não existe.

IOException

Um ficheiro no diretório de destino com o mesmo nome está em uso.

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

PathTooLongException

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

UnauthorizedAccessException

O utilizador não tem a permissão necessária.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

Exemplos

Este exemplo copia o ficheiro Test.txt para o diretório TestFiles2 sem sobrescrever ficheiros existentes.

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

Substitui os caminhos dos ficheiros pelos caminhos que queres usar no teu código.

Este exemplo copia o ficheiro Test.txt para o diretório TestFiles2 e renomeia-o NewFile.txtpara .

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

Substitui os caminhos dos ficheiros pelos caminhos que queres usar no teu código.

Observações

CopyFile não preserva ACEs (Controlo de Acesso Entradas). O ficheiro recém-criado herda ACEs por defeito do diretório onde foi criado.

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

Para	Veja
Copie um ficheiro para o mesmo diretório.	Como: Criar uma cópia de um ficheiro no mesmo diretório em Visual Basic
Copie um ficheiro para um diretório diferente.	Como: criar uma cópia de um ficheiro num diretório diferente em Visual Basic

Ver também

UICancelOption

Aplica-se a

CopyFile(String, String, UIOption)

Copia um ficheiro 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 ficheiro a ser copiado.

destinationFileName: String

O local para onde o ficheiro deve ser copiado.

showUI: UIOption

Se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.

Exceções

ArgumentException

destinationFileName contém informação de caminho.

ArgumentNullException

destinationFileName ou sourceFileName é Nothing ou uma corda vazia.

FileNotFoundException

O ficheiro fonte não é válido ou não existe.

IOException

O ficheiro de destino existe e overwrite é definido para False.

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

PathTooLongException

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

UnauthorizedAccessException

O utilizador não tem a permissão necessária.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

Exemplos

Este exemplo copia o ficheiro Test.txt para o diretório TestFiles2 sem sobrescrever ficheiros existentes.

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

Substitui os caminhos dos ficheiros pelos caminhos que queres usar no teu código.

Este exemplo copia o ficheiro Test.txt para o diretório TestFiles2 e renomeia-o NewFile.txtpara .

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

Substitui os caminhos dos ficheiros pelos caminhos que queres usar no teu código.

Observações

CopyFile não preserva ACEs (Controlo de Acesso Entradas). O ficheiro recém-criado herda ACEs por defeito do diretório onde foi criado.

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

Para	Veja
Copie um ficheiro para o mesmo diretório.	Como: Criar uma cópia de um ficheiro no mesmo diretório em Visual Basic
Copie um ficheiro para um diretório diferente.	Como: criar uma cópia de um ficheiro num diretório diferente em Visual Basic

Ver também

UICancelOption

Aplica-se a

CopyFile(String, String, Boolean)

Copia um ficheiro 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 ficheiro a ser copiado.

destinationFileName: String

O local para onde o ficheiro deve ser copiado.

overwrite: Boolean

True se os ficheiros existentes devem ser sobrescritos; caso contrário False. A predefinição é False.

Exceções

ArgumentException

destinationFileName contém informação de caminho.

ArgumentNullException

destinationFileName ou sourceFileName é Nothing ou uma corda vazia.

FileNotFoundException

O ficheiro fonte não é válido ou não existe.

IOException

O ficheiro de destino existe e overwrite é definido para False.

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

PathTooLongException

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

UnauthorizedAccessException

O utilizador não tem a permissão necessária.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

Exemplos

Este exemplo copia o ficheiro Test.txt para o diretório TestFiles2 sem sobrescrever ficheiros existentes.

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

Substitui os caminhos dos ficheiros pelos caminhos que queres usar no teu código.

Este exemplo copia o ficheiro Test.txt para o diretório TestFiles2 e renomeia-o NewFile.txtpara .

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

Substitui os caminhos dos ficheiros pelos caminhos que queres usar no teu código.

Observações

CopyFile não preserva ACEs (Controlo de Acesso Entradas). O ficheiro recém-criado herda ACEs por defeito do diretório onde foi criado.

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

Para	Veja
Copie um ficheiro para o mesmo diretório.	Como: Criar uma cópia de um ficheiro no mesmo diretório em Visual Basic
Copie um ficheiro para um diretório diferente.	Como: criar uma cópia de um ficheiro num diretório diferente em Visual Basic

Ver também

UICancelOption

Aplica-se a

CopyFile(String, String, UIOption, UICancelOption)

Copia um ficheiro 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 ficheiro a ser copiado.

destinationFileName: String

O local para onde o ficheiro deve ser copiado.

showUI: UIOption

Se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.

onUserCancel: UICancelOption

Especifica o que deve ser feito se o utilizador clicar em Cancelar durante a operação. A predefinição é ThrowException.

Exceções

ArgumentException

destinationFileName contém informação de caminho.

ArgumentNullException

destinationFileName ou sourceFileName é Nothing ou uma corda vazia.

FileNotFoundException

O ficheiro fonte não é válido ou não existe.

IOException

O ficheiro de destino existe e overwrite é definido para False.

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

PathTooLongException

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

UnauthorizedAccessException

O utilizador não tem a permissão necessária.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

OperationCanceledException

UICancelOption está definido para ThrowException, e o utilizador cancelou a operação ou ocorre um erro de E/S não especificado.

Exemplos

Este exemplo copia o ficheiro Test.txt para o diretório TestFiles2 sem sobrescrever ficheiros existentes.

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

Substitui os caminhos dos ficheiros pelos caminhos que queres usar no teu código.

Este exemplo copia o ficheiro Test.txt para o diretório TestFiles2 e renomeia-o NewFile.txtpara .

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

Substitui os caminhos dos ficheiros pelos caminhos que queres usar no teu código.

Observações

CopyFile não preserva ACEs (Controlo de Acesso Entradas). O ficheiro recém-criado herda ACEs por defeito do diretório onde foi criado.

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

Para	Veja
Copie um ficheiro para o mesmo diretório.	Como: Criar uma cópia de um ficheiro no mesmo diretório em Visual Basic
Copie um ficheiro para um diretório diferente.	Como: criar uma cópia de um ficheiro num diretório diferente em Visual Basic

Ver também

UICancelOption

Aplica-se a

Comentários

Esta página foi útil?