Sun Chili!Soft ASP Sun Chili!Soft
ASP Sun Microsystems

 

VBScript 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: VBScript FileSystemObject Object OpenTextFile Method

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

Arguments: VBScript 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 created; False if it isn't created. The default is False. 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: VBScript FileSystemObject Object OpenTextFile Method

The iomode arguments 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: VBScript FileSystemObject Object OpenTextFile Method

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

Sub OpenTextFileTest

Const ForReading = 1, ForWriting = 2, ForAppending = 3

Dim fs, f

Set fs = CreateObject("Scripting.FileSystemObject")

Set f = fs.OpenTextFile("c:\testfile.txt", ForAppending,TristateFalse)

f.Write "Hello world!"

f.Close

End Sub

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Legal Notice.