MoveFolder Method

  • Article

 

Moves one or more folders from one location to another.

Syntax

object.MoveFolder ( source, destination );

Arguments

  • object
    Required. Always the name of a FileSystemObject.

  • source
    Required. The path to the folder or folders to be moved. The source argument string can contain wildcard characters in the last path component only.

  • destination
    Required. The path where the folder or folders are to be moved. The destination argument can't contain wildcard characters.

Remarks

If source contains wildcards or destination ends with a path separator (\), it is assumed that destination specifies an existing folder in which to move the matching files. Otherwise, destination is assumed to be the name of a destination folder to create. In either case, three things can happen when an individual folder is moved:

  • If destination does not exist, the folder gets moved. This is the usual case.

  • If destination is an existing file, an error occurs.

  • If destination is a directory, an error occurs.

An error also occurs if a wildcard character that is used in source doesn't match any folders. The MoveFolder method stops on the first error it encounters. No attempt is made to roll back any changes made before the error occurs.

Important This method allows moving folders between volumes only if supported by the operating system.

The following example illustrates the use of the MoveFolder method:

function MoveFldr2Desktop(fldrspec)
{
   var fso;
   fso = new ActiveXObject("Scripting.FileSystemObject");
   fso.MoveFolder(fldrspec, "c:\\windows\\desktop\\");
}

Sub MoveAFolder(Drivespec)
   Dim fso
   Set fso = CreateObject("Scripting.FileSystemObject")
   fso.MoveFolder Drivespec, "c:\windows\desktop\"
End Sub

Applies To:

FileSystemObject Object

See Also

CopyFile Method
DeleteFile Method
GetFile Method
GetFileName Method
Move Method
MoveFile Method
OpenTextFile Method