OPEN Function (File)
Opens an ASCII or binary file. This function does not create the file if it does not exist.
[Ok := ] File.OPEN(Filename[,TextEncoding.value])
Parameters
- File
Type: File Specifies the file.
- Filename
Type: Text Specifies the name and path of the file to open.
- TextEncoding
Value: MsDos, UTF8, UTF16, or Windows Optionally, you can specify the encoding on the file. By specifying the text encoding, you ensure that all the language-specific characters are represented correctly in Microsoft Dynamics NAV when you read data and write data. For more information, see Text Encoding.
Property Value/Return Value
Type: Boolean
Specifies whether the file was opened. If you omit this optional return value and if the file cannot be found, then a run-time error occurs.
true if the file was opened; otherwise, false.
Remarks
If you call OPEN on a file variable that refers to an open file, then the function does not automatically close the existing file and open the new file. You must explicitly call the CLOSE Function (File) to close the existing file. If you call OPEN on a file that is already open, then a run-time error occurs.
Example
This example shows how to open an .xml file for reading in text mode. To use this example, you must create the simple.xml file at C:\temp and create the following variable.
| Variable | DataType |
|---|---|
TestFile |
File |
TestFile.TEXTMODE(TRUE);
TestFile.WRITEMODE(FALSE);
TestFile.OPEN('C:\temp\simple.xml');
If you want to be explicit about the encoding of a file, you can set the TextEncoding parameter. The following code example replaces the last statement in the previous example.
TestFile.TEXTMODE(TRUE);
TestFile.WRITEMODE(FALSE);
TestFile.OPEN('C:\temp\simple.xml', TextEncoding::Windows);