Assembly: libdb_dotnet181 (in libdb_dotnet181.dll) Version: 18.1.32.0
Syntax
C# |
---|
public void Close() |
Visual Basic (Declaration) |
---|
Public Sub Close |
Visual C++ |
---|
public: void Close() |
Remarks
The object should not be closed while any other handle that refers to it is not yet closed; for example, database environment handles must not be closed while transactions in the environment have not yet been committed or aborted. When you close each database handle, by default, the database is not synchronized. To synchronize all open databases ensure that the last environment object is closed by the CloseForceSync() method. When the close operation fails, the method returns a non-zero error value for the first instance of such error, and continues to close the rest of the environment objects.
Where the environment was configured with UseTxns, calling CloseForceSync aborts any unresolved transactions. Applications should not depend on this behavior for transactions involving Berkeley DB databases; all such transactions should be explicitly resolved. The problem with depending on this semantic is that aborting an unresolved transaction involving database operations requires a database handle. Because the database handles should have been closed before calling CloseForceSync, it is not possible to abort the transaction, and recovery should be run on the Berkeley DB environment before further operations are done.
In multithreaded applications, only a single thread may call CloseForceSync.