FileSystemObject Object

One function of FileSystemObject object is the manipulation of text file of the file system.

FileSystemObject.CreateTextFile

FileSystemObject.CopyFile method is the method to return a TextStream object corresponding to the specified file after creation for text manipulation related to the specified FileSystemObject.

Syntax:

FileSystemObjectName.CreateTextFile(filename[,overwrite[, unicode]])

 Or in VBScript. Imply

Set textobjectname=FileSystemObjectName.CreateTextFile(filename[,overwrite[, unicode]])

 Or in JScript. Imply

textobjectname=FileSystemObjectName.CreateTextFile(filename[,overwrite[, unicode]])

Parameters:

textobjectname

The parameter "textobjectname" is the name assigned to the instance of the TextStream object returned by the method using the FileSystemObjectName.CreateTextFile Method after the specified File is created.

FileSystemObjectName

The parameter "FileSystemObjectName" is used to specify the name of the instance of the FileSystemObject Object related to. Folder object is another possible alternate object of FileSystemObject for the CreateTextFile Method.

filename

The parameter "filename" is used to specify the path and file name specification string of the file to be created.

overwrite

The optional parameter "overwrite" is a boolean value used to indicate that the existing file in destination is to be overwritten or not. The default value of parameter overwrite is false. Files are overwritten if the boolean value is true. Files are not overwritten if the boolean value is false.

unicode

The optional parameter "unicode" is a boolean value used to indicate that created file specified in destination is created as a Unicode or ASCII file. The default value of parameter unicode is false. File is created as a Unicode file if the boolean value is true. File is created as an ASCII file if the boolean value is false.

Remarks:

FileSystemObjectName refers to a FileSystemObject Object. And Folder object is another possible alternate object of FileSystemObject for the CreateTextFile Method.

An error occurs if the overwrite parameter is false, or is not provided while the specified file that already exists.

Examples:

• Example of using the CreateTextFile method to create a specificed text file and open the TextStream object corresponding to the created text file accordingly.

  ASP VBScript command:

  <script runat="server" language="VBScript">
  Dim fso, textobjectname
  Set fso = CreateObject("Scripting.FileSystemObject")
  Set textobjectname = fso.CreateTextFile( "d:\temp1\test.txt", True)
  Response.Write textobjectname.line
  textobjectname.Close
  </script>

  HTML web page ouput:

  1

• Example of using the CreateTextFile method to create a specificed text file and open the TextStream object corresponding to the created text file accordingly.

  ASP JScript command:

  <script runat="server" language="JScript">
  var fso, textobjectname;
  fso = new ActiveXObject("Scripting.FileSystemObject");
  textobjectname = fso.CreateTextFile("d:\\temp1\\test.txt", "True");
  Response.Write(textobjectname.line + "<br />");
  textobjectname.Close();
  </script>

  HTML web page ouput:

  1

FileSystemObject.OpenTextFile Method

FileSystemObject.OpenTextFile method is the method to return a TextStream object corresponding to the specified file after opening for text manipulation, that is read from, write to, or append to the file, related to the specified FileSystemObject Object.

Syntax:

FileSystemObjectName.OpenTextFile(filename[, iomode[, create[, format]]])

 Or in VBScript. Imply

Set textobjectname = FileSystemObjectName.OpenTextFile(filename[, iomode[, create[, format]]])

 Or in JScript. Imply

textobjectname = FileSystemObjectName.OpenTextFile(filename[, iomode[, create[, format]]])

Parameters:

textobjectname

The parameter "textobjectname" is the name assigned to the instance of the TextStream object returned by the method using the FileSystemObjectName.OpenTextFile Method after the specified File is opened.

FileSystemObjectName

The parameter "FileSystemObjectName" is used to specify the name of the instance of the FileSystemObject Object related to.

filename

The parameter "filename" is used to specify the file specification to be opened by the OpenTextFile Method. The parameter filespec can contain wildcard characters in the last path component.

iomode

The optional parameter "iomode" is used to specify the i/o operation mode of the OpenTextFile Method for the opened specified file. The value of parameter "iomode" can be.

create

The optional parameter "create" is a Boolean value used to specify whether a new file can be created or not if the specified filename does not exist. A new file is created if the boolean value is true. A new file is not created if the boolean value is false. The default value of parameter overwrite is false and a new file is not created if the optional parameter is omitted.

format

The optional parameter "create" is a Tristate value used to specify the format of the opened file. The file is opened as ASCII if the optional parameter is omitted. The three Tristate values are

Remarks:

FileSystemObjectName should always refer to a FileSystemObject Object.

Examples:

• Example of using the OpenTextFile method to read the specified files

  ASP VBScript command:

  <script runat="server" language="VBScript">
  Dim fso, textobjectname
  Set fso = CreateObject("Scripting.FileSystemObject")
  Set textobjectname = fso.OpenTextFile("d:\temp1\test.txt")
  Response.Write textobjectname.Readline
  textobjectname.Close
  </script>

  HTML web page ouput:

  line 1

• Example of using the OpenTextFile method to read the specified files

  ASP JScript command:

  <script runat="server" language="JScript">
  var fso, textobjectname ;
  fso = new ActiveXObject("Scripting.FileSystemObject");
  textobjectname = fso.OpenTextFile("d:\\temp1\\test.txt")
  Response.Write(textobjectname.Readline());
  textobjectname.Close();
  </script>;

  HTML web page ouput:

  line 1