Microsoft® Visual Basic® Scripting Edition CreateTextFile Method

Language Reference

See Also                   Applies to

Description

Creates a specified file name and returns a TextStream object that can be used to read from or write to the file.

Syntax

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

The CreateTextFile 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 create.
overwrite	Optional. Boolean value that indicates whether you can overwrite an existing file. The value is True if the file can be overwritten, False if it can't be overwritten. If omitted, existing files are not overwritten.
unicode	Optional. Boolean value that indicates whether the file is created as a Unicode or ASCII file. The value is True if the file is created as a Unicode file, False if it's created as an ASCII file. If omitted, an ASCII file is assumed.

Remarks

The following code illustrates how to use the CreateTextFile method to create and open a text file:

Set fs = CreateObject("Scripting.FileSystemObject")
Set a = fs.CreateTextFile("c:\testfile.txt", True)
a.WriteLine("This is a test.")
a.Close

If the overwrite argument is False, or is not provided, for a filename that already exists, an error occurs.