CDatabase Class Members
Data Members
| m_hdbc | Open Database Connectivity (ODBC) connection handle to a data source. Type HDBC. |
Construction
| CDatabase | Constructs a CDatabase object. You must initialize the object by calling OpenEx or Open. |
| Open | Establishes a connection to a data source (through an ODBC driver). |
| OpenEx | Establishes a connection to a data source (through an ODBC driver). |
| Close | Closes the data source connection. |
Database Attributes
| GetConnect | Returns the ODBC connect string used to connect the CDatabase object to a data source. |
| IsOpen | Returns nonzero if the CDatabase object is currently connected to a data source. |
| GetDatabaseName | Returns the name of the database currently in use. |
| CanUpdate | Returns nonzero if the CDatabase object is updatable (not read-only). |
| CanTransact | Returns nonzero if the data source supports transactions. |
| SetLoginTimeout | Sets the number of seconds after which a data source connection attempt will time out. |
| SetQueryTimeout | Sets the number of seconds after which database query operations will time out. Affects all subsequent recordset Open, AddNew, Edit, and Delete calls. |
| GetBookmarkPersistence | Identifies the operations through which bookmarks persist on recordset objects. |
| GetCursorCommitBehavior | Identifies the effect of committing a transaction on an open recordset object. |
| GetCursorRollbackBehavior | Identifies the effect of rolling back a transaction on an open recordset object. |
Database Operations
| BeginTrans | Starts a “transaction” — a series of reversible calls to the AddNew, Edit, Delete, and Update member functions of class CRecordset — on the connected data source. The data source must support transactions for BeginTrans to have any effect. |
| BindParameters | Allows you to bind parameters before calling CDatabase::ExecuteSQL. |
| CommitTrans | Completes a transaction begun by BeginTrans. Commands in the transaction that alter the data source are carried out. |
| Rollback | Reverses changes made during the current transaction. The data source returns to its previous state, as defined at the BeginTrans call, unaltered. |
| Cancel | Cancels an asynchronous operation or a process from a second thread. |
| ExecuteSQL | Executes an SQL statement. No data records are returned. |
Database Overridables
| OnSetOptions | Called by the framework to set standard connection options. The default implementation sets the query timeout value. You can establish these options ahead of time by calling SetQueryTimeout. |