VBScript FileSystemObject Object CreateTextFile Method

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

Syntax: VBScript FileSystemObject Object CreateTextFile Method

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

Arguments: VBScript FileSystemObject Object CreateTextFile Method

object

The name of a FileSystemObject or Folder object. Required.

filename

A string expression that identifies the file to create. Required.

overwrite

A Boolean value that indicates if an existing file can be overwritten. The value is True if the file can be overwritten; False if it can't be overwritten. If omitted, existing files are not overwritten. Optional.

unicode

A 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. Optional.

Remarks: VBScript FileSystemObject Object CreateTextFile Method

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

Sub CreateAfile

Set fs = CreateObject("Scripting.FileSystemObject")

Set a = fs.CreateTextFile("c:\testfile.txt", True)

a.WriteLine("This is a test.")

a.Close

End Sub

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