Append Method (DatabaseEntry, Transaction)

BerkeleyDB

Append the data item to the end of the database.

Namespace:  BerkeleyDB
Assembly:  libdb_dotnet48 (in libdb_dotnet48.dll) Version: 4.8.24.0

Syntax

C#
public uint Append(
	DatabaseEntry data,
	Transaction txn
)
Visual Basic (Declaration)
Public Function Append ( _
	data As DatabaseEntry, _
	txn As Transaction _
) As UInteger
Visual C++
public:
unsigned int Append(
	DatabaseEntry^ data, 
	Transaction^ txn
)

Parameters

data
Type: BerkeleyDB..::.DatabaseEntry
The data item to store in the database
txn
Type: BerkeleyDB..::.Transaction
If the operation is part of an application-specified transaction, txn is a Transaction object returned from BeginTransaction()()(); if the operation is part of a Berkeley DB Concurrent Data Store group, txn is a handle returned from BeginCDSGroup()()(); otherwise null.

Return Value

The record number allocated to the record

Remarks

There is a minor behavioral difference between Append(DatabaseEntry) and Append(DatabaseEntry). If a transaction enclosing an Append operation aborts, the record number may be reallocated in a subsequent Append(DatabaseEntry) operation, but it will not be reallocated in a subsequent Append(DatabaseEntry) operation.

See Also