TEXTMODE Function (File)

  • Article

Sets whether a file should be opened as an ASCII file or a binary file. Gets the current setting of this option for a file.

[IsTextmode := File.TEXTMODE([SetTextmode])

Parameters

  • File
    Type: File Specifies the file.
  • SetTextmode
    Type: Boolean Specifies the mode in which the file will be opened when File.OPEN is called. If SetTextmode is true, the file will be opened as an ASCII file. If SetTextmode is false, the file will be opened as a binary file.

Property Value/Return Value

Type: Boolean

The current setting of this option for the file.

true if the file will be opened as an ASCII file; otherwise, false if the file will be opened as a binary file.

Remarks

This function should be used before File.OPEN is used to open the file. If you use this function on a file that is already open, then an error occurs.

Example

The following example sets the TEXTMODE to true when the file is open for writing. This means the file contents will be written to a text file that is named 'C:\TestFolder\TestFile.txt' by using ASCII characters. The WRITEMODE Function (File) and the OPEN Function (File) open the file for writing and the text ‘Hello World’ is written. The CLOSE Function (File) closes the file after the file is written to. This example requires that you create the following variable in the C/AL Globals window. This example assumes that you have created a text file that is named C:\TestFolder\TestFile.txt.

Variable name DataType

TestFile

File

 
TestFile.TEXTMODE(TRUE);
TestFile.WRITEMODE(TRUE);
TestFile.OPEN('C:\TestFolder\TestFile.txt');
TestFile.WRITE('Hello World');
TestFile.CLOSE;

See Also

Reference

File Data Type