CDatabase类

    xiaoxiao2023-03-24  2

    CDatabase对象表示到数据源的连接,通过它可以操作数据源。数据源是位于一些数据库管理系统(DBMS)的数据的指定实例,包括MicrosoftSQLServerMicrosoftAccessBorlanddBASExBASE。在应用中可以同时使一个或多个CDatabase对象活动。

    注意:

    如果在处理数据访问对象(DAO)类而不是开放数据库连接(ODBC)类,可使用类CDaoDatabase

    为使用CDatabase,构造一个CDatabase对象并调用它的OpenEx成员函数。这打开了一个连接。在接着构造CRecordset对象以操纵连接的数据源时,向CDatabase对象传递记录集构造程序指针。完成使用连接时调用Close成员函数并销毁CDatabase对象。Close关闭以前没有关闭的任何记录集。

    #include<afxdb.h>

    1.      建立连接:

    要建立与数据源的连接,首先应构造一个CDatabase对象,然后再调用CDatabase的Open成员函数Open函数负责建立连接,其声明为:

    virtual BOOL Open( LPCTSTR lpszDSN, BOOL bExclusive = FALSE, BOOL bReadOnly = FALSE, LPCTSTR lpszConnect ="ODBC;", BOOL bUseCursorLib = TRUE ); throw( CDBException, CMemoryException );

    说明:

    1)      参数lpszDSN指定了数据源名(构造数据源的方法将在后面介绍),在lpszConnect参数中也可包括数据源名,此时lpszDSN必需为NULL,若在函数中未提供数据源名且使lpszDSN为NULL,则会显示一个数据源对话框,用户可以在该对话框中选择一个数据源。

    2)      参数bExclusive说明是否独占数据源,由于目前版本的类库还不支持独占方式,故该参数的值应该是FALSE,这说明数据源是被共享的。

    3)      参数bReadOnly若为TRUE则对数据源的连接是只读的。

    4)      参数lpszConnect指定了一个连接字符串,连接字符串中可以包括数据源名、用户帐号(ID)和口令等信息,字符串中的“ODBC”表示要连接到一个ODBC数据源上。

    5)      参数bUseCursorLib若为TRUE,则会装载光标库,否则不装载,快照需要光标库,动态集不需要光标库。

    6)      若连接成功,函数返回TRUE,若返回FALSE,则说明用户在数据源对话框中按了Cancel按钮。若函数内部出现错误,则框架会产生一个异常。

    例子:

    1)      CDatabase m_db; //在文档类中嵌入一个CDatabase对象

    2)      //连接到一个名为"Student Registration"的数据源

    m_db.Open("Student Registration");

    3)      //在连接数据源的同时指定了用户帐号和口令

    m_db.Open(NULL,FALSE,FALSE,"ODBC;DSN=Student Registration;UID=ZYF;PWD=1234");

    4)      m_db.Open(NULL); //将弹出一个数据源对话框

    2.      要从一个数据源中脱离,可调用函数Close。在脱离后,可以再次调用Open函数来建立一个新的连接。

    3.      调用IsOpen可判断当前是否有一个连接。

    4.      调用GetConnect可返回当前的连接字符串。

    5.      相关函数声明:

    virtual void Close( );

    BOOL IsOpen( ) const; //返回TRUE则表明当前有一个连接

    const CString& GetConnect( ) const;

    6.      CDatabase的析构函数会调用Close,所以只要删除了CDatabase对象就可以与数据源脱离。

    7.      CDatabase类成员

    数据成员

    m_hdbc

    对数据源的开放数据库连接(ODBC)连接句柄。类型HDBC

    构造函数

    CDatabase

    构造一个CDatabase对象。必须通过调用OpenEx或Open初始化这个对象

    Open

    建立到数据源的一个连接(通过ODBC驱动程序)

    OpenEx

    建立到数据源的一个连接(通过ODBC驱动程序)

    Close

    关闭数据源连接

    数据库属性

    GetConnect

    返回用于连接CDatabase对象和数据源的ODBC连接字符串

    IsOpen

    如果CDatabase对象当前与数据源连接,则返回非零

    GetDatabaseName

    返回当前使用的数据库名字

    CanUpdate

    如果CDatabase可更新(不是只读的),则返回非零

    CanTransact

    如果数据源支持事务,则返回非零

    SetLoginTimeout

    设置数据源连接试图超时的秒数

    SetQueryTimeout

    设置数据库查询操作超时的秒数。影响以后的所有记录集调用:Open,AddNew,Edit和Delete

    GetBookmarkPersistence

    标识记录集对象上书签持久化操作

    GetCursorCommitBehavior

    标识在打开的记录集对象上提交事务的效果

    GetCursorRollbackBehavior

    标识在打开的记录集对象上回滚事务的效果

    数据库操作

    BeginTrans

    在连接的数据源上开始“事务”──类CRecordset的一系列可回滚的AddNew,Edit,Delete和Update成员函数调用。数据源必须支持事务才能使BeginTrans有效

    BindParameters

    允许在调用CDatabase::ExecuteSQL前绑定参数

    CommitTrans

    完成由从BeginTrans开始的事务。执行这个事务中改变数据源的命令

    Rollback

    回滚当前事务期间所做变化,数据源返回到BeginTrans调用时定义的未改变的以前状况

    Cancel

    取消第二个线程的异步操作或处理

    ExecuteSQL

    执行一条SQL语句。不返回数据记录

    数据库覆盖

    OnSetOptions

    框架调用以设置标准连接选项。缺省实现设置查询超时值。可以通过调用SetQueryTimeout提前建立这些选项

    转载请注明原文地址: https://ju.6miu.com/read-1201580.html
    最新回复(0)