Creates and opens an ASCII or binary file. If the file already exists, it will be truncated and then opened.
[Ok := ] File.CREATE(Name) |
Parameters
- File
- Type: FileSpecifies the file to create.
- Name
- Type: Text or codeThe name of the file that include the path.
The following rules apply:
- You can omit the drive designation if the
file is located on the current drive.
- You can omit the full path if the file is
located in the current directory.
- You can enter only the subdirectory name if
the file is located in a subdirectory of the current
directory.
- You can omit the drive designation if the
file is located on the current drive.
Property Value/Return Value
Type: Boolean
Specifies whether the file was created.
true if the file was created; otherwise, false.
Remarks
If the TEXTMODE Function (File) returns true and you read or write to the file, text is put in the buffer.
If the TEXTMODE Function (File) function returns false, binary information is put in the buffer.
If you call CREATE on a File variable that refers to an open file, the function does not automatically close the existing file and create the new file. You must explicitly call the CLOSE Function (File) to close the existing file. Otherwise, a run-time error occurs.
Example
The following example creates a file that is named TestFile.txt in the path C:\TestFolder\ .The TestFile variable stores the file and path that is created. If the file is created, a message that states that the file is created is displayed. Otherwise, an error message is displayed. This example requires that you create the following variable in the C/AL Globals window.
Variable name | DataType |
---|---|
TestFile |
File |
Copy Code | |
---|---|
IF TestFile.CREATE('C:\TestFolder\TestFile.txt') THEN BEGIN MESSAGE('%1 is created', TestFile.NAME) END ELSE ERROR('The file could not be created'); |