Purpose
Used to insert a new record into the database.
Syntax (Method)
object.Insert
Key, Data, KeyBefore, InstanceBefore
| Key
(String) |
|
The
new record's key is assigned this value. |
| Data
(Byte Array) |
|
The
new record's data is assigned this value. |
| KeyBefore
(String) |
|
The
new record is inserted just before the InstanceBefore
instance of an existing record containing this key. |
| InstanceBefore
(Long) |
|
The
new record is inserted just before this instance of an existing
record containing KeyBefore. |
Notes
This method allows duplicate keys to exist in the database.
Hence, if this method is called with a key (Key)
that already exists in the database, a new record will still be
inserted with the specified key (Key).
Error
Values
After calling this method, the property ErrorNumber
will report one of the following values:
rtCDP_ErrNoError
rtCDP_ErrKeyTooLong
rtCDP_ErrDataTooLong
rtCDP_ErrRecordNotFound
rtCDP_ErrDatabaseFull
Example
See
InsertArray.
Version
History
1.0 2/2/2001 Tested
See
Also
Insert,
InsertB, InsertArray, InsertRec, InsertRecB