DeleteFolder Method

Deletes a specified folder and its contents.

Syntax

object.DeleteFolder ( folderspec[, force] ); 

Arguments

  • object
    Required. Always the name of a FileSystemObject.

  • folderspec
    Required. The name of the folder to delete. The folderspec can contain wildcard characters in the last path component.

  • force
    Optional. Boolean value that is true if folders with the read-only attribute set are to be deleted; false (default) if they are not.

Remarks

The DeleteFolder method does not distinguish between folders that have contents and those that do not. The specified folder is deleted regardless of whether or not it has contents.

An error occurs if no matching folders are found. The DeleteFolder method stops on the first error it encounters. No attempt is made to roll back or undo any changes that were made before an error occurred.

The following example illustrates the use of the DeleteFolder method.

function DeleteFolder(folderspec)
{
   var fso;
   fso = new ActiveXObject("Scripting.FileSystemObject");
   fso.DeleteFolder(folderspec);
}
Sub DeleteAFolder(filespec)
   Dim fso
   Set fso = CreateObject("Scripting.FileSystemObject")
   fso.DeleteFolder(filespec)
End Sub

Applies To:

FileSystemObject Object

See Also

CopyFolder Method
CreateFolder Method
Delete Method
DeleteFile Method
MoveFolder Method