Click or drag to resize

VoDbSeek Function (Usual, Logic, Logic)

X#
Move to the record having the specified key value.

Namespace:  XSharp.RT
Assembly:  XSharp.RT (in XSharp.RT.dll) Version: 2.19
Syntax
Copy
 FUNCTION VoDbSeek(
	uKey AS USUAL,
	lSoftSeek AS LOGIC,
	lLast AS LOGIC
) AS LOGIC
Request Example View Source

Parameters

uKey
Type: Usual
A value of any type that specifies the key value associated with the desired record.
lSoftSeek
Type: Logic
Determines how the work area is positioned if the specified key value is not found: TRUE performs a soft seek; FALSE does not.
lLast
Type: Logic

Return Value

Type: Logic
VODBSeek() always returns TRUE.
Remarks
VODBSeek() is like DbSeek() but is strongly typed. 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.
See DbSeek(Usual, Usual, Usual) for more information
Examples
In this example, VODBSeek() moves the pointer to the record in the database, EMPLOYEE, in which the value in the field cName matches the entered value of cName:
X#
Copy
1ACCEPT "Employee name: " TO cName
2IF (Employee->(VODBSeek(cName), FALSE))
3    Employee->(ViewRecord())
4ELSE
5    ? "Not found"
6END
See Also