Retrieve a key/data pair from the database. In the presence of duplicate key values, Get will return the first data item for key.

Namespace:  BerkeleyDB
Assembly:  libdb_dotnet53 (in libdb_dotnet53.dll) Version: 5.3.28.0

Syntax

C#
public KeyValuePair<DatabaseEntry, DatabaseEntry> Get(
	DatabaseEntry key,
	Transaction txn
)
Visual Basic (Declaration)
Public Function Get ( _
	key As DatabaseEntry, _
	txn As Transaction _
) As KeyValuePair(Of DatabaseEntry, DatabaseEntry)
Visual C++
public:
KeyValuePair<DatabaseEntry^, DatabaseEntry^> Get(
	DatabaseEntry^ key, 
	Transaction^ txn
)

Parameters

key
Type: BerkeleyDB..::.DatabaseEntry
The key to search for
txn
Type: BerkeleyDB..::.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

A KeyValuePair<(Of <(TKey, TValue>)>) whose Key parameter is key and whose Value parameter is the retrieved data.

Remarks

If txn is null and the operation occurs in a transactional database, the operation will be implicitly transaction protected.

Exceptions

ExceptionCondition
BerkeleyDB..::.NotFoundException A NotFoundException is thrown if key is not in the database.
BerkeleyDB..::.KeyEmptyException A KeyEmptyException is thrown if the database is a QueueDatabase or RecnoDatabase database and key exists, but was never explicitly created by the application or was later deleted.

See Also