VoDbClearLocate Function | |
Clear a locate condition by deleting the locate code block.
Namespace:
XSharp.RT
Assembly:
XSharp.RT (in XSharp.RT.dll) Version: 2.19
Syntax FUNCTION VoDbClearLocate() AS LOGIC
public static bool VoDbClearLocate()
Request Example
View SourceReturn Value
Type:
Logic
TRUE if successful; otherwise, FALSE.
Remarks
VODBClearLocate() clears the locate condition by deleting the locate code block.
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
A locate condition can be set by DBLocate(), VODBLocate(), VODBSetLocate(), or the LOCATE command.
This function, however, does not call the error handler and will not, therefore, produce a runtime error message or create an error object if it fails.
Thus, it may be important to check the return value to determine if the function succeeded.
the LastRddError property in the runtime state. will contain needed information regarding any error that occurs.
Examples
This example sets and retrieves a locate code block, evaluates it against the current record, and finally cleans up:
1DBUseArea(TRUE, "DBFNTX", "address",;
2 "Address", TRUE)
3VODBSetLocate({|| Name == "Odile"})
4
5VODBClearLocate()
6
7DBCloseArea()
See Also