Append

Purpose
Used to append a new record to the end of the database.

Syntax (Method)
object.Append pKey, pData

Parameters
pKey (String)   The new record's key is assigned this value.
pData (String)   The new record's value.

Notes
This method allows duplicate keys to exist in the database. Hence, if this method is called with a key (pKey) that already exists in the database, a new record will still be appended with the specified key (pKey).

Error Values
After calling this method, the property ErrorNumber will report one of the following values:

rtCDP_ErrNoError
rtCDP_ErrDatabaseFull
rtCDP_ErrKeyTooLong
rtCDP_ErrDataTooLong

Example
Objective: Add 2 new records to the database.

'Create the object
Dim CDP As rtCDP.rtCompactDataPak
Set CDP = New
rtCDP.rtCompactDataPak
'Append 2 new records
CDP.Append "Name", "John Doe"
CDP.Append "E-Mail", "jdoe@abcresume.com"

CDP now contains 2 records (0 through 1)

Rec Key Data
0 Name John Doe
1 E-Mail jdoe@abcresume.com

Version History
1.0 1/30/2001 Tested

See Also
AppendB, Data, DataB, Insert, InsertB