DBCursorGetValue
Gets the value of the specified column of the current row (i.e., the cursor position) in a SQL result set.
| Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
|---|---|---|---|---|---|---|
| DBCursorGetValue | Database/ERP | Synchronous | Supported | Supported | Supported | Executed on Server |
Note: This feature emulates SQL (Structured Query Language) database operations. You should be familiar with how SQL commands are formed and executed before you use this feature.
Syntax
DBCursorGetValue( numCur, strColumn, "optStrErrorTag" )
- numCur
- The cursor handle for the result set. The cursor handle is returned by DBCursorOpen or DBCursorOpenSQL.
- strColumn
- The name of the column.
- optStrErrorTag
- The name of a String tag that will receive detailed error messages, if errors occur during runtime.
Note: The tag name should be enclosed in quotes, as shown in the syntax diagram, or else the function will try to use the value of the tag.
This is an optional parameter.
Returned value
Returns the value of the specified column. If the value is NULL or the cursor is invalid, then it returns an empty string with quality BAD.
Notes
You can use the Studio Database Gateway to directly monitor database connections for leaks and errors. For more information, see Database Interface.
Examples
As used in a Math worksheet:
| Tag Name | Expression |
|---|---|
| Tag | DBCursorGetValue( nCursor, “Column1″ ) |