Xbasic

SQL::Row Class

Description

SQL::Row Class properties and methods

A SQL::ResultSet object will contain one or more SQL::Row objects. The following script retrieves data into a SQL::ResultSet, extracts a SQL::Row with SQL::ResultSet.NextRow(), then lists the properties of one of the row's SQL::DataTypeInfo objects.

dim conn as SQL::Connection
dim rs as SQL::ResultSet
dim cr as SQL::Row
dim dti as SQL::DataTypeInfo
dim connString as C
dim select_exp as C
connString = "{A5API='Access', FileName='c:\program files\a5v8\mdbfiles\alphasports.mdb'}"
select_exp = "select Lastname from customer where bill_state_region = 'ma'"
if .not. conn.open(connString)
ui_msg_box("Error", conn.CallResult.text)
end
end if
if .not. conn.execute(select_exp)
ui_msg_box("Error", conn.CallResult.text)
conn.close()
end
end if
rs = conn.ResultSet
rs.NextRow()
cr = rs.CurrentRow
dti = cr.ColumnInfo[1]
ui_msg_box("Column One Definition", property_to_string(dti))
conn.close()

Properties

RowIndexNumeric

Type: "N", Mode: "R", Default = -1. Row index of the current row.

ColumnInfoPointer

Type: "P", Mode: "R", An array of column descriptions of type SQL::DataTypeInfo.

ColumnCountNumeric

Type: "N", Mode: "R", Default = -1. The number of columns in the result set.

DBFRowSyntaxCharacter

Type: "C", Mode: "R", Default = "". The syntax required to create an Alpha Anywhere .DBF table with the same columns.

RowIndexOnPageNumeric

Type: "N", Mode: "RW", Default = -1. Row index of the current row with respect to the current page of data.This value is used mainly for formatting expressions, where the row is passed in as a parameter.The row is set manually or through the creation of the object in SQL::ResultSet::FormatData().

Methods

ColumnNumber Method

Get the number of the column named.

Data Method

Get the value of the data column specified.

DataIsNull Method

Determine whether a given element is Null.

FormatData Method

Format the data for the column name, index or definition specified.

See Also