Name
Folder.Move Method
Syntax
oFolderObj
.Movedestination
-
oFolderObj
Use: Required
Data Subtype: Folder object
Any object variable returning a Folder object.
-
destination
Use: Required
Data Subtype: 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 & 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; however, since, because 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 ...
Get VBScript in a Nutshell 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.