FileName

Intended name of the file.

 

 

String

When set to a file name, the file is opened. When set to an empty string, the file is closed.

When set to an empty string and then changed to a file name, a file is created or opened according to FileMode. If an existing file is opened, the value of the Size property determines how the file is treated:

If Size = 0 when the file is opened, it is assumed the file is being opened for reading, and Size is set to the size of the file.

If Size > 0 when the file is opened, it is assumed the file is being opened for writing, and the existing contents of the file are replaced.

When set to a file name and then changed to an empty string, all data in the file is buffered to memory and the file is closed.

When set to a file name and then changed to a different file name, the file is moved to the new location. If FileMode = createUnique, an existing file cannot be unintentionally overwritten.

You can delete a file only by setting this property to an existing file name, setting FileMode to createOpen or createExisting, setting DeleteOnDestroy to True, and allowing the DartStream Object to be destroyed.