'Declaration
 
Public Overloads Sub CopyItemsTo( _
   ByVal events As FileSystemEvents, _
   ByVal userData As Object, _
   ByVal destinationFolder As AbstractFolder, _
   ByVal recursive As Boolean, _
   ByVal includeFolders As Boolean, _
   ByVal replaceExistingFiles As Boolean, _
   ByVal filters() As Object _
) 

'Usage
 
Dim instance As AbstractFolder
Dim events As FileSystemEvents
Dim userData As Object
Dim destinationFolder As AbstractFolder
Dim recursive As Boolean
Dim includeFolders As Boolean
Dim replaceExistingFiles As Boolean
Dim filters() As Object
 
instance.CopyItemsTo(events, userData, destinationFolder, recursive, includeFolders, replaceExistingFiles, filters)

public void CopyItemsTo( 
   FileSystemEvents events,
   object userData,
   AbstractFolder destinationFolder,
   bool recursive,
   bool includeFolders,
   bool replaceExistingFiles,
   object[] filters
)

Parameters

events

A FileSystemEvents object that will be used to raise events. Cannot be a null reference (Nothing in Visual Basic).

userData

Opaque data that will be passed back to the event handler when an event is raised.

destinationFolder

An AbstractFolder object into which the folder's content must be copied. Cannot be null.

recursive

true if the content of the folders contained in the subfolders should be copied; false if only the current folder's content should be copied.

includeFolders

true if empty subfolders should be included in the copy operation; false otherwise.

replaceExistingFiles

true if existing files in the destination should be replaced; false otherwise.

filters

An array of objects that can be used to filter the items to be copied.

If the physical folder specified by destinationFolder does not exist, it is created.

The difference between CopyItemsTo() and CopyFilesTo() is how empty sub-folders are handled. CopyItemsTo() includes empty sub-folders in the copy operation while CopyFilesTo() only includes files and files found in sub-folders in the copy operation. Unless you specifically want to copy empty folders, it is best to use CopyFilesTo().

The folder's content (files, empty folders and subfolders) that matches the provided filters is
immediately copied to the destination.

When replacingExistingFiles is true, any file in the destination that has the same name as a file being copied is automatically replaced.

When replacingExistingFiles is false, an exception is thrown whenever the destination contains a file with the same name as a file being copied.

To filter a list of files or folders, you can pass a variable number of objects in the filters parameter. These objects may be of the following types:

FileSystemEvents.ItemProgression: Every time a file is about to be copied, reports how many files have been copied and the total number of files that must be copied.

FileSystemEvents.ByteProgression: Every 32k, reports how many bytes have been and must be copied for the current file, as well as for the entire set of files that are being copied.

FileSystemEvents.ItemException: An exception occurs while copying a file, reports the exception and allows to recover from the exception and continue copying the files.

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

AbstractFolder Class
AbstractFolder Members
Overload List