Functions.DbRecall Method (Usual)
Restore the current record if it has been marked for deletion.
XSharp.RT (in XSharp.RT.dll) Version: 2.16
Syntax Request Example
uArea AS USUAL
) AS LOGIC
public static bool DbRecall(
- Type: Usual
Specifies the work area name or number for a table on which the operation must be performed.
TRUE if successful; otherwise, FALSE.
By default, this function operates on the currently selected work area.
It can be made to operate on an unselected work area by specifying
it within an aliased expression or by calling the overload that accepts a workarea
parameter (a workarea number or alias ).
DBRecall() performs the same function as the RECALL command.
For more information, refer to the DELETE and RECALL commands.
Logical records: Reinstating a deleted record affects the record's logical visibility if SetDeleted() is TRUE.|
For more information, refer to the DBDelete() function and the DELETE and RECALL commands.
Shared mode: For a shared database, DBRecall() requires the current record to be locked.
The following example recalls a record if it is deleted and attempts to lock the record if successful:
1cLast := "Winston"
2DBUseArea(TRUE, "DBFNTX", "sales", "Sales", TRUE)
5 IF Sales->Deleted()
6 IF Sales->RLock()
8 QOut("Record recalled")
10 QOut("Unable to lock record...")
14 QOut("Not found")