Share via


FileCopy Function 

Copies a file.

The My.Computer.FileSystem Object gives you greater productivity and performance in file I/O operations than FileCopy. See My.Computer.FileSystem.CopyFile Method for more information.

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

Parameters

  • Source
    Required. 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
    Required. String expression that specifies the target file name. Destination may include the directory or folder, and drive, of the destination file.

Exceptions

Exception type Error number Condition

ArgumentException

52

Source or Destination is invalid or not specified.

IOException

55

File is already open.

FileNotFoundException

53

File does not exist.

See the "Error number" column if you are upgrading Visual Basic 6.0 applications that use unstructured error handling. (You can compare the error number against the Number Property (Err Object).) However, when possible, you should consider replacing such error control with Structured Exception Handling Overview for Visual Basic.

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.

Example

This example uses the FileCopy function to copy one file to another. For purposes of this example, assume that SrcFile is a file containing some 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.

Smart Device Developer Notes

This function is not supported.

Requirements

Namespace: Microsoft.VisualBasic

Module: FileSystem

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

See Also

Tasks

How to: Create a Copy of a File in a Different Directory in Visual Basic
How to: Create a Copy of a File in the Same Directory in Visual Basic
How to: Copy a Directory to Another Directory in Visual Basic

Reference

Kill Function
IOException Class
FileNotFoundException Class
ArgumentException