Microsoft® Visual Basic® Scripting Edition CreateTextFile Method | Language Reference Version 2

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:

> Part | Description
> object | Required. Always the name of a FileSystemObject or Folder object.
> filename | Required. String expression that identifies the file to create.
> overwrite | Optional. 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.
> 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:

> >     Sub CreateAfile
> >         Set fso = CreateObject("Scripting.FileSystemObject")
> >         Set a = fso.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.

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.