Xojo Documentation Xojo Documentation

Shared Method

TextOutputStream.Append(f as FolderItem) As TextOutputStream

New in 2009r5

Opens the passed file so that text can be appended to existing text.

Notes

If no file exists at the specified location, one is created. If the file cannot be created or opened for appending, an IOException is raised. The append is done by calling Write or WriteLine. The Append shared method replaces the deprecated FolderItem.AppendToTextFile.

Example

This example appends the text in TextField1 to the text file that was opened by GetOpenFolderItem:

Dim f As FolderItem = GetOpenFolderItem(FileTypes1.Text)
If f <> Nil Then
Try
Dim t As TextOutputStream = TextOutputStream.Append(f)
t.Write(TextField1.Text)
Catch e As IOException
// handle error
End Try
End If