PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Binding between a control and a WLanguage variable or between a control and an item of a data file
  • Updating the items: Special cases
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
<Page>.ToFile (Function)
In french: <Page>.VersFichier
ODBCNot available with this kind of connection
Automatically updates:
  • the value of the items in a data file with the value of the controls in the page. The data file items bound to the page controls are automatically updated with the values of these controls (even if they are grayed, inactive or invisible).
  • the value of the WLanguage variables with the value of the page controls. The WLanguage variables bound to the page controls are automatically updated with the values of these controls (even if they are grayed, inactive or invisible).
PHP Only the binding to the items of a data file is supported. Bindings to WLanguage variables are not supported in this version.
Remark: <Page>.ToFile cannot be used to write to the data file: the variables of the data file items can only be updated (i.e variables of the record loaded in memory). To modify the records, you must use <Source>.Add, <Source>.Modify, <Source>.Write, etc.
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
Example
// Click the "Add" button
PAGE_Customer.ToFile()
HAdd("Customer")
IF HErrorDuplicates() = True THEN Error("This number already exists")
Syntax
<Page>.ToFile([<Source>])
<Page>: Page name
Name of the page that contains the controls.
<Source>: Optional character string (with or without quotes)
Name of the source containing the data to update. This source can be:
  • The name of a data file: only the controls bound to the items of the data file are taken into account.
  • The name of a WLanguage variable: only the controls bound to the WLanguage variable are taken into account.
    Remarks:
    • If the name of the variable is enclosed in quotes, the control will be bound to the specified variable.
    • If the name of the variable is not enclosed in quotes, the control will be bound to the variable data (e.g., a variable containing the name of another variable).
If this name is not specified, all the page controls bound to an item of a data file described in the data model editor or to a WLanguage variable will be taken into account.
Remarks

Binding between a control and a WLanguage variable or between a control and an item of a data file

The binding between a control and a WLanguage variable or between a control and an item of a data file can be determined:
  • In the editor, in the control description window ("Binding" tab)
  • In the code, with the DataBinding property.

Updating the items: Special cases

  • To automatically assign the NULL value to an item with <Page>.ToFile:
    1. Check "NULL supported" for the item in the data model editor.
    2. Select the "NULL if empty" option in the Edit control bound to the item.
  • The items of the data file that are not bound to a control are not updated by <Page>.ToFile.
  • If multiple controls in the page are bound to the same data file item, <Page>.ToFile may not update the bound item properly. It is not recommended to bind multiple page controls to the same item.
  • <Page>.ToFile does not update the items with the values from Image controls. Use <Source>.LinkMemo.
  • <Page>.ToFile is not available on views.
Component: wd260page.dll
Minimum version required
  • Version 24
Comments
Click [Add] to post a comment