Name
FileSystemObject.DeleteFolder Method
Syntax
oFileSysObj
.DeleteFolderFileSpec
[,Force
]
-
oFileSysObj
Use: Required
Data Subtype: FileSystemObject object
Any object variable returning a FileSystemObject object.
-
FileSpec
Use: Required
Data Subtype: String
The name and path of the folders to delete.
-
Force
Use: Optional
Data Subtype: Boolean
If set to
True
, the read-only flag on a file is ignored and the file deleted. By default, its value isFalse
; read-only files will not be deleted.
Description
Removes a given folder and all its files and subfolders.
Rules at a Glance
FileSpec
can contain wildcard characters as the final path component, which allows multiple folders that meet the file specification to be deleted.FileSpec
can’t end with a path separator.FileSpec
can be a relative or absolute path.If any of the files within the specified folders are open, the method fails with a “Permission Denied” error.
The DeleteFolder method deletes all contents of the given folder, including other folders and their contents.
If the specified folder can’t be found, the method fails.
Programming Tips & Gotchas
If an error occurs while deleting more than one file or folder, the DeleteFolder method exits immediately, thereby leaving the rest of the folders or files undeleted. There is also no rollback facility to undo the deletions prior to the error.
DeleteFolder permanently deletes folders and their contents; it doesn’t move them to the Recycle Bin.
The DeleteFolder method differs from the Delete method ...
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.