"FileSystemObject" Class

ASP Tutorials - Herong's Tutorial Examples

∟"FileSystemObject" Class - File System

This section provides a tutorial example on how to use the FileSystemObject class that represents the file system on the Web server. FileSystemObject class is provided in the Scripting Runtime DLL, scrrun.dll.

FileSystemObject: A class represents the file system of the operating system where the Web server is running. Major methods and properties include:

"Drives": Property to return a read-only collection of "Drive" objects representing all drives in the current file system.
"GetDrive(drivePath)": Method to return a Drive object of the specified drive path (driver letter with ':').
"GetFolder(folderPath)": Method to return a Folder object of the specified folder path name.
"GetFile(filePath)": Method to return a File object of the specified file path name.
"CreateTextFile(pathname,[override[,unicode]])": Method to create a new text file and return a TextStream object connected to the new file. "override=true|false" specifies if the new file can override an existing file. "unicode=false|true" specifies if the new should written with unicode encoding.
"OpenTextFile(pathname[,io_mode[,create[,tristate]]])": Method to open a file and returns a TextStream object connected to the file. "create=false|true" specifies that if a new can be created when the specified file does not exists. io_mode(=1|2|8: ForReading|ForWriting|ForAppending) specifies how the file should be openned. tristate(=-2|-1|0: TristateUserDefault|TristateTrue|TristateFalse) specifies if the file should be open as Unicode or not.
"CopyFile(from_pathname, to_pathname)": Method to copy a file specified by the from_pathname to the to_pathname.
"DeleteFile()": Method to delete a file.
"MoveFile()": Method to move a file.
"FileExists()": Method to check if a file exists.
"CreateFolder": Method to create a folder.
"CopyFolder()": Method to copy a folder.
"DeleteFolder()": Method to delete a folder.
"MoveFolder()": Method to move a folder.
"FolderExists()": Method to check if a folder exists.
"DriveExists": Method to check if a drive exists.

Below is a simple ASP page to how to create a folder and copy a file by using the FileSystemObject class.

<script language="vbscript" runat="server">
'  file_sytem.asp
'  Copyright (c) 1999 by Dr. Herong Yang
'  This program shows how to use the FileSystemObject class.
'
   response.write("<html><body>")
   response.write("<b>Tests on the FileSystemObject class</b>:<br/>")
   ' Getting the FileSystemObject object
   set fs = CreateObject("Scripting.FileSystemObject")
   if fs.FolderExists("c:\temp\backup") then 
      fs.DeleteFolder("c:\temp\backup")
   end if
   set d = fs.CreateFolder("c:\temp\backup")
   fs.CopyFile "c:\inetpub\wwwroot\file_system.asp", _
      "c:\temp\backup\file_system.asp"
   response.write("File copied: c:\temp\backup\file_system.asp<br/>")
   response.write("</body></html>")
</script>

Output:

Tests on the FileSystemObject class:
File copied: c:\temp\backup\file_system.asp

It's interesting to note that:

VBScript statements can be continued to the next line with "_" as the end character.
File name must be specified in the to_pathname for the CopyFile() method.