Instantiate a new Database object and open the database represented
by Filename. The file specified by
Filename must exist.
Namespace:
BerkeleyDBAssembly: libdb_dotnet181 (in libdb_dotnet181.dll) Version: 18.1.32.0
Syntax
C# |
---|
public static Database Open( string Filename, DatabaseConfig cfg, Transaction txn ) |
Visual Basic (Declaration) |
---|
Public Shared Function Open ( _ Filename As String, _ cfg As DatabaseConfig, _ txn As Transaction _ ) As Database |
Visual C++ |
---|
public: static Database^ Open( String^ Filename, DatabaseConfig^ cfg, Transaction^ txn ) |
Parameters
- Filename
- Type: System..::.String
The name of an underlying file used to back the database. In-memory databases never intended to be preserved on disk may be created by setting this parameter to null.
- cfg
- Type: BerkeleyDB..::.DatabaseConfig
The database's configuration
- 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
A new, open database object
Remarks
If Filename is null, the database is strictly temporary and cannot be opened by any other thread of control, thus the database can only be accessed by sharing the single database object that created it, in circumstances where doing so is safe.
If txn is null, but AutoCommit is set, the operation is implicitly transaction protected. Transactionally protected operations on a database object requires the object itself be transactionally protected during its open. The transaction must be committed before the object is closed.