Retrieve a key/data pair from the database. In the presence of
duplicate key values, Get returns the first data item for
key.
Namespace:
BerkeleyDBAssembly: libdb_dotnet181 (in libdb_dotnet181.dll) Version: 18.1.32.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 is implicitly transaction
protected.
Exceptions
Exception | Condition |
---|---|
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. |