Name
Folder.Move Method
Syntax
oFolderObj
.Movedestination
oFolderObj
Use: Required
Data Type: Folder object
A Folder object.
destination
Use: Required
Data Type: String
The path to the location where the folder or folders are to be moved.
Description
Moves a folder structure from one location to another.
Rules at a Glance
Wildcard characters can’t be used in
destination
.If any of the files within the folder being moved are open, an error is generated.
All subfolders and files contained within the source folder are copied to
destination
, unless disallowed by the wildcard characters. That is, the Move method is recursive.destination
can be either an absolute or a relative path.
Programming Tips and Gotchas
If a fatal system error (like a power failure) occurs during the execution of this method, the worst that can happen is that the folder is copied to the destination but not removed from the source. There are no rollback capabilities built into the Folder.Move method; since, the copy part of this two-stage process is executed first, the folder can’t be lost.
If an error occurs in the middle of a move operation, the operation is terminated, and the remaining files and folders in the folder aren’t moved.
If a folder or a file by the same name already exists in
destination
, the method generates runtime error 58, “File already exists.” To prevent this, you can use the FileSystemObject’s FolderExists and GetAbsolutePath methods prior to calling the Move method.Unlike the FileSystemObject’s MoveFolder ...
Get VBScript in a Nutshell, 2nd Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.