FileSystem.FileCopy(String, String) Method

Reference

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Copies a file. The FileSystem gives you better productivity and performance in file I/O operations than FileCopy. See CopyFile(String, String) for more information.

public:
 static void FileCopy(System::String ^ Source, System::String ^ Destination);

public static void FileCopy (string Source, string Destination);

static member FileCopy : string * string -> unit

Public Sub FileCopy (Source As String, Destination As String)

Parameters

Source: String

Required. A string expression that specifies the name of the file to be copied. Source may include the directory or folder, and drive, of the source file.

Destination: String

Required. A string expression that specifies the destination file name. Destination may include the directory or folder, and drive, of the destination file.

Exceptions

ArgumentException

Source or Destination is invalid or not specified.

IOException

File is already open.

FileNotFoundException

File does not exist.

Examples

This example uses the FileCopy function to copy one file to another. For purposes of this example, assume that SrcFile is a file that contains data.

Dim SourceFile, DestinationFile As String
SourceFile = "SRCFILE"   ' Define source file name.
DestinationFile = "DESTFILE"   ' Define target file name.
FileCopy(SourceFile, DestinationFile)   ' Copy source to target.

Remarks

If you try to use the FileCopy function on a currently open file, an error occurs.

FileCopy requires full trust to work on the local drive.

Applies to