RecordB

Purpose
This property can be used to read or update a record in the database. It provides an intuitive way to manipulate records as if they were elements in an array.

Syntax (Read/Write Property)
(Read) Data = object.RecordB(Index)
(Write) object.RecordB(Index) = Data

Parameters (Read)

Index (Long)

This is the record number you want to read from.

Return Value (Read)

Data (Byte Array)

This is the data returned from the specified record.

Parameters (Write)

Index (Long)

This is the record number you want to write to.

Assigned Value (Write)

Data (Byte Array)

This is the data to assign to the specified record.

Notes (Read)
This property allows you to retrieve data from a specified record.

If the specified record (Index) does not exist, the property returns a zero-length string and ErrorNumber reports rtCDP_ErrRecordNotFound.

If any errors occur, the function returns a zero-length string ("").

Notes (Write)
This property allows you to update records in the database.

If the specified record number (Index) is higher than the highest record in the database, then all necessary records are added until the specified record exists. The new records have zero-length keys and data, except for the specified record, which is assigned the specified data (Data).

All records added by this property contain zero-length keys.

If any errors occur, no records are changed.

Error Values (Read)
After reading this property, the property ErrorNumber will report one of the following values:

rtCDP_ErrNoError
rtCDP_ErrRecordNotFound

Error Values (Write)
After writing this property, the property ErrorNumber will report one of the following values:

rtCDP_ErrNoError
rtCDP_ErrDataTooLong
rtCDP_ErrRecordNotFound

Example
See Record.

Version History
(Read) 1.0 2/2/2001 Tested
(Write) 1.0 2/2/2001 Tested

See Also
Record, RecordKey