Microsoft® Visual Basic® Scripting Edition
OpenTextFile Method
Language Reference

See Also                   Applies to


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

Syntax

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

The OpenTextFile method has these parts:

Argument Description
object Optional. Object is always the name of a FileSystemObject.
filename Required. String expression that identifies the file to open.
iomode Optional. Constant, either ForReading or ForAppending, indicating that the file is open for reading or appending.
create Optional. 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. If omitted, a new file isn't created.
format Optional. One of three Tristate values used to indicate the format of the opened file. If omitted, the file is opened as ASCII.

Settings
The format argument can have any of the following settings:

Value Description
TristateTrue Open the file as Unicode.
TristateFalse Open the file as ASCII.
TristateUseDefault Open the file using the system default.

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

Dim fs, a
Set fs = CreateObject("Scripting.FileSystemObject")
Set a = fs.OpenTextFile("c:\testfile.txt", ForAppending, FALSE)
...
a.Close

© 1997 Microsoft Corporation. All rights reserved. Legal Notices.