JScript FileSystemObject Object OpenTextFile Method

Opens a specified file and returns a TextStream object that can be used to read from or append to the file.

Syntax: JScript FileSystemObject Object OpenTextFile Method

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

Arguments: JScript FileSystemObject Object OpenTextFile Method

object

The name of a FileSystemObject. Required.

filename

A String expression that identifies the file to open. Required.

iomode

Indicates input/output mode. Can be one of three constants: ForReading, ForWriting, or ForAppending. Optional.

create

A Boolean value that indicates whether a new file can be created if the specified filename doesn't exist. The value is True if a new file is to be created, False if it isn't to be created. If omitted, a new file isn't created. Optional.

format

One of three Tristate values used to indicate the format of the opened file. If omitted, the file is opened as ASCII. Optional.

Settings: JScript FileSystemObject Object OpenTextFile Method

The iomode argument can have any of the following settings:

Constant	Value	Description
ForReading	1	Open a file for reading only. You can't write to this file.
ForWriting	2	Open a file for writing. If a file with the same name exists, its previous contents are overwritten.
ForAppending	8	Open a file and write to the end of the file.

The format argument can have any of the following settings:

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

Remarks: JScript FileSystemObject Object OpenTextFile Method

The following code illustrates the use of the OpenTextFile method to open a file for appending text:

var fs, a, ForAppending;

ForAppending = 8;

fs = new ActiveXObject("Scripting.FileSystemObject");

a = fs.OpenTextFile("c:\\testfile.txt", ForAppending, false);

...

a.Close();