Help / WLanguage / Managing databases / HFSQL / HFSQL functions
  • Managing the password
  • Creating or opening a data file
  • Opening a data file that is already opened
  • Managing the list of data files used (.REP)
  • Managing fatal errors
  • Opening a connection and the specified table
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Opens a data file.
Remark: The opening of data files is managed automatically. However, in some cases, you may have to explicitly open a data file (to check the file existence or the password validity for example).
// Open Customer data file
// Check status report of <source>.Open
IF Customer.Open("ABCD", hORead) = False THEN
Error("Unable to open the Customer data file" + HErrorInfo())
<Result> = <Source>.Open([<Password> [, <Access mode>]])
<Result>: Boolean
  • True if the data file was opened.
  • False if a problem occurred (wrong password, ...). HError is used to identify the error. HErrorInfo returns more details.
<Source>: Type corresponding to the specified source
Name of data file used (logical name, defined in the analysis).
<Password>: Optional character string
Password of the data file.
If no password is associated with the data file, you have the ability to use an empty string ("").
<Access mode>: Optional integer constant
Configures the access mode to the data file.
If this parameter is not specified, the data file will be opened according to its characteristics (if the data file is read-only, it will be opened in read-only ; if the data file is read/write, it will be opened in read/write mode).
hOReadThe data file can be accessed in read-only mode. It is only possible to read records. It is not possible to add or remove records.
hOReadWriteThe data file can be accessed in read/write mode. It is possible to read and write new records.

Hyper File 5.5 This parameter is ignored.
PHP This parameter is ignored.

Managing the password

The password can be specified:
  • when the data file is opened with <Source>.Open,
  • before the data file is opened with <Source>.Password.

Creating or opening a data file

HCreationIfNotFound can replace <Source>.Open. Indeed, if the data file exists, it is automatically opened.

Opening a data file that is already opened

If <Source>.Open is used on a data file already opened with a different <Access mode>, the filters, locks and characteristics of the current iteration are lost.

Managing the list of data files used (.REP)

WINDEV Mobile allows you to update a list of data files used by the application (equivalent to the.REP file in WINDEV).
<Source>.Open specifies the list of data files used by the application (.REP for WINDEV and WEBDEV) if updates are enabled for this list.

Managing fatal errors

If a fatal error occurs when opening a data file, it may be interesting to continue the program while processing the error. To do so, we recommend that you perform the following exception process:
Error("HFSQL error: " + HError())
Trace("File opened")
PHP Not available.
WINDEVWEBDEV - Server codeReports and QueriesJavaUser code (UMC)External languagePHPOLE DBNative Connectors (Native Accesses)

Opening a connection and the specified table

If necessary, <Source>.Open opens the connection to the database before opening the specified table. If the connection is already open (with the same parameters), this connection is automatically used.
Remark: The connection used by default corresponds to the connection associated with the table in the data model editor.
Component: wd300hf.dll
Minimum version required
  • Version 25
This page is also available for…
Click [Add] to post a comment

Last update: 07/06/2023

Send a report | Local help