CDatabase 類別

發行項
06/10/2015

表示資料來源的連接，您可以在資料來源。

class CDatabase : public CObject

Members

公用建構函式

名稱	描述
CDatabase::CDatabase	建構 CDatabase 物件。您必須呼叫 OpenEx 或開啟初始化物件。

公用方法

名稱	描述
CDatabase::BeginTrans	開始一個交易」— 「為 AddNew、編輯、刪除和更新類別 CRecordset 成員函式的一系列可復原的呼叫—在連接的資料來源。資料來源必須支援 BeginTrans 的交易產生作用。
CDatabase::BindParameters	可讓您存取內建參數在呼叫 CDatabase::ExecuteSQL之前。
CDatabase::Cancel	取消非同步作業或處理序從第二個執行緒。
CDatabase::CanTransact	如果資料來源支援交易，則會傳回非零。
CDatabase::CanUpdate	傳回非零，如果 CDatabase 物件不可更新 (唯讀)。
CDatabase::Close	關閉資料來源連接。
CDatabase::CommitTrans	完成 BeginTrans開始的交易。修改資料來源在交易中執行的命令。
CDatabase::ExecuteSQL	執行 SQL 陳述式。資料錄不會傳回。
CDatabase::GetBookmarkPersistence	識別書籤在資料錄集物件保存的作業。
CDatabase::GetConnect	傳回用來連接至資料來源的 CDatabase ODBC 連接字串物件。
CDatabase::GetCursorCommitBehavior	識別認可交易的影響至開啟資料錄集物件。
CDatabase::GetCursorRollbackBehavior	識別復原交易的影響在開啟資料錄集物件。
CDatabase::GetDatabaseName	傳回目前使用中之資料庫的名稱。
CDatabase::IsOpen	如果 CDatabase 物件目前連接到資料來源，則會傳回非零。
CDatabase::OnSetOptions	呼叫框架設定標準連接選項。預設實作會將查詢逾時值。您可以藉由呼叫 SetQueryTimeout事先建立這些選項。
CDatabase::Open	建立資料來源的連接 (透過 ODBC 驅動程式)。
CDatabase::OpenEx	建立資料來源的連接 (透過 ODBC 驅動程式)。
CDatabase::Rollback	在交易期間所做的變更與相反。資料來源返回之前的狀態，並且定義於 BeginTrans 呼叫時，並未變更。
CDatabase::SetLoginTimeout	將秒數，也就是資料來源連接嘗試將逾時。
CDatabase::SetQueryTimeout	將秒數，之後資料庫查詢作業會逾時。會影響所有後續的資料錄集開啟、 AddNew、編輯和刪除呼叫。

公用資料成員

名稱	描述
CDatabase::m_hdbc	開放式資料庫連接 (Open Database Connectivity，ODBC) 資料來源的連接控制代碼。輸入 HDBC。

備註

資料來源是某些資料庫管理系統裝載的資料的特定執行個體 (Referential Integrity)。範例包括 Microsoft SQL Server、Microsoft Access， Borland dBASE 和 xBASE。您可以同時具有一或多個物件 CDatabase 現用在您的應用程式。

注意事項
如果您使用存取資料時使用物件 (DAO) 類別而不是開放式資料庫連接 (ODBC) 類別會使用類別， CDaoDatabase 。如需詳細資訊，請參閱本文概觀:資料庫程式開發。

使用 CDatabase， CDatabase 建構物件並呼叫它的 OpenEx 成員函式。這會開啟連接。當您然後再建運作的 CRecordset 物件在連接的資料來源時，請透過資料錄集建構函式指標至 CDatabase 物件。當您完成使用連接時，請呼叫關閉成員函式和終結 CDatabase 物件。關閉結束您先前未關閉的所有資料錄集。

如需 CDatabase的資訊，請參閱 Microsoft 知識庫文件資料來源 (ODBC) 和概觀:資料庫程式開發。