McDBDatabase objects represent database definitions and the instance defined by that defintion's current state.
Object Model
Remarks
Since McDBDatabase objects are capable of representing any of the states of a an actual database, the database instance represented by an McDBDatabase may be either valid or invalid, open or closed, and have any allowable name and path, among other defining characterstics. McDBDatabase objects are the containers for all database objects and are the source for all events fired from McDBLib.
This method will delete this McDBDatabase, when possible. This McDBDatabase must not be open and the backing file system files must be deletable for this operation to succeed.
Each open McDBDatabase instance is associated with entries from the local configuration file (McDBLib.Cfg), defining the logical name of the McDBDatabase and its local (or logical remote) Path, along with any number of configuation strings managed and used solely by the database engine. This property will assign and retrieve these values.
Whether this database (and objects read from it) are Read only. By default this property is False (i.e. databases are opened for both read and write access).
This event is fired when an McDBNode instance is locked, either internally by a pending McDBTransaction (for data integrity) or explicitly (by locking the object in another thread/process).
This event is fired whenever an McDBNode instance is stored/updated. This event does not necessarily require a modification, just a database store event. This event also uses the mcdbModifyContext parameter to limit the scope of the modification(s) encapsulated by the notification. If the event is triggered by another database client, the context parameter will be either mcdbNodeAttribute or mcdbNotNodeAttribute. No additional granularity is available in this condition. This event also provides a varaint parameter containing the string name of the property/attribute that changed when the mcdbModifyContext is for one of these contexts is set. If more than one property or attribute or a combination of property(ies) and attribute(s) are changed in the same 1-second event cycle, this ContextName will be Empty.