Draft for Information Only

Content


        FileSystemObject Object
 FileSystemObject.CreateTextFile
  
        Syntax:
  
        Parameters:
  
        Remarks:
  
        Examples:
 FileSystemObject.OpenTextFile Method
  
        Syntax:
  
        Parameters:
  
        Remarks:
  
        Examples:

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.

Constant	Value	Description
ForReading	1	The file is opened for reading only. No text can be written to the file.
ForWriting	2	The file is opened for writing.
ForAppending	8	The file is opened for writing to the end of the file. Text is appended to the text file only

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

Constant	Value	Description
TristateUseDefault	-2	The file is opened as the file using the system default.
TristateTrue	-1	The file is opened as Unicode.
TristateFalse	0	The file is opened as ASCII.

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

©sideway

ID: 130300032 Last Updated: 3/26/2013 Revision: 0 Ref:

References

Active Server Pages, , http://msdn.microsoft.com/en-us/library/aa286483.aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929%28v=vs.90%29.aspx
ASP Best Practices, , http://technet.microsoft.com/en-us/library/cc939157.aspx
ASP Built-in Objects, , http://msdn.microsoft.com/en-us/library/ie/ms524716(v=vs.90).aspx
Response Object, , http://msdn.microsoft.com/en-us/library/ms525405(v=vs.90).aspx
Request Object, , http://msdn.microsoft.com/en-us/library/ms524948(v=vs.90).aspx
Server Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525541(v=vs.90).aspx
Application Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525360(v=vs.90).aspx
Session Object (IIS), , http://msdn.microsoft.com/en-us/library/ms524319(8v=vs.90).aspx
ASPError Object, , http://msdn.microsoft.com/en-us/library/ms524942(v=vs.90).aspx
ObjectContext Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525667(v=vs.90).aspx
Debugging Global.asa Files, , http://msdn.microsoft.com/en-us/library/aa291249(v=vs.71).aspx
How to: Debug Global.asa files, , http://msdn.microsoft.com/en-us/library/ms241868(v=vs.80).aspx
Calling COM Components from ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524620(v=VS.90).aspx
IIS ASP Scripting Reference, , http://msdn.microsoft.com/en-us/library/ms524664(v=vs.90).aspx
ASP Keywords, , http://msdn.microsoft.com/en-us/library/ms524672(v=vs.90).aspx
Creating Simple ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524741(v=vs.90).aspx
Including Files in ASP Applications, , http://msdn.microsoft.com/en-us/library/ms524876(v=vs.90).aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929(v=vs.90).aspx
FileSystemObject Object, , http://msdn.microsoft.com/en-us/library/z9ty6h50(v=vs.84).aspx
http://msdn.microsoft.com/en-us/library/windows/desktop/ms675944(v=vs.85).aspx, , ADO Object Model
ADO Fundamentals, , http://msdn.microsoft.com/en-us/library/windows/desktop/ms680928(v=vs.85).aspx