PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

This content has been translated automatically. Click here to view the French version.
  • 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
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
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).
Versions 15 and later
Android This function is now available for Android applications.
New in version 15
Android This function is now available for Android applications.
Android This function is now available for Android applications.
Versions 17 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for iPhone/iPad applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Versions 18 and later
Android Widget This function is now available in Android widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Android Widget This function is now available in Android widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Example
// Ouvre le fichier de données Client
HOpen(Client)
// Ouvre tous les fichiers de données avec le mot de passe "PSW"
HOpen("*", "PSW")
// Test du compte-rendu de la fonction HOuvre
IF HOpen(Client, "ABCD", hORead) = False THEN
Error("Impossible d'ouvrir le fichier de données Client" + HErrorInfo())
END
Syntax
<Result> = HOpen([<Data file> [, <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.
<Data file>: Optional character string
Name of data file used (logical name, defined in the analysis).
If this name is not specified, HOpen will use the last data file used by the last HFSQL management function (function starting with "H").
If this parameter is corresponds to "*", all the data files described in the analysis are opened. If the password is specified, this password will be used to open all the data files.
This parameter can also correspond to the name of a group of files (or custom-folder) defined in the analysis (not available in Android and Android widget). If the password is specified, this password will be used to open all the data files of the group.
Caution: this parameter cannot correspond to an variable of type File description.
<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).
hOReadWriteThe data file can be accessed in read/write. You have the ability to read the records and to write new records.
hOReadThe data file can be accessed in read-only. You only have the ability to read the records. No record can be added or deleted.

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

Managing the password

The password can be specified:
  • or directly to the of the data file opening with the HOpenfunction,
  • or before opening of the data file with the HPass function.

Creating or opening a data file

HCreationIfNotFound can replace HOpen. Indeed, if the data file exists, it is automatically opened.

Opening a data file that is already opened

If HOpen is used on a data file already opened with a different <Access mode>, the filters, locks and characteristics of the current browse 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).
The HOpen function fills in the list of data files handled by the application (.REP for WINDEV and WEBDEV) if the update of this list is activated.

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:
WHEN EXCEPTION IN
HOpen(PERE)
DO
Error("Erreur HFSQL: " + HError())
ELSE
Trace("Fichier ouvert")
END
PHP Not available.
WINDEVWEBDEV - Server codeReports and QueriesJavaUser code (UMC)External languagePHPOLE DBNative Connectors (Native Accesses)

Opening a connection and the specified table

The HOpen function opens the connection to the database if necessary before opening the specified table. If the connection is already opened (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: wd270hf.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment