Rename the database specified by file and database to newname. If no database is specified, the underlying file represented by file is renamed using the value supplied to newname, incidentally renaming all of the databases it contained.

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

Syntax

C#
public void RenameDB(
	string file,
	string database,
	string newname,
	bool autoCommit,
	Transaction txn
)
Visual Basic (Declaration)
Public Sub RenameDB ( _
	file As String, _
	database As String, _
	newname As String, _
	autoCommit As Boolean, _
	txn As Transaction _
)
Visual C++
public:
void RenameDB(
	String^ file, 
	String^ database, 
	String^ newname, 
	bool autoCommit, 
	Transaction^ txn
)

Parameters

file
Type: System..::.String
The physical file which contains the database(s) to be renamed.
database
Type: System..::.String
The database to be renamed.
newname
Type: System..::.String
The new name of the database or file.
autoCommit
Type: System..::.Boolean
If true, enclose RenameDB within a transaction. If the call succeeds, changes made by the operation will be recoverable. If the call fails, the operation will have made no changes.
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. If null, but autoCommit or AutoCommit is true, the operation will be implicitly transaction protected.

See Also