CDatabase クラス

データ ソースへの接続を表します。これを通じてデータ ソース上で操作を行うことができます。

class CDatabase : public CObject

メンバー

パブリック コンストラクター

名前	説明
CDatabase::CDatabase	CDatabase オブジェクトを構築します。OpenEx か [開く]を呼び出してオブジェクトを初期化する必要があります。

パブリック メソッド

名前	説明
CDatabase::BeginTrans	—接続されたデータ ソースのトランザクション「…」— CRecordset クラスの AddNew、[編集]、[削除]と 更新 のメンバー関数に一連の呼び出し元の開始します。データ ソースは効果が得られるように BeginTrans のトランザクションをサポートする必要があります。
CDatabase::BindParameters	割り当て CDatabase::ExecuteSQLを呼び出す前にパラメーターへのバインド。
CDatabase::Cancel	2 番目のスレッドからの非同期操作またはプロセスを取り消します。
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	データ ソースの ODBC (Open Database Connectivity) 接続のハンドル。型 HDBC。

解説

データ ソースは、データベース管理システム (DBMS) がホストするデータの特定のインスタンスです。例では、Microsoft SQL Server、Microsoft Access、Borland の dBASE と xBASE が含まれます。アプリケーションの CDatabase の一つ以上のオブジェクトをアクティブに一度に指定できます。

[!メモ]

(DAO) ではなく、並べ替える Data Access Objects を使用すると、ODBC (Open Database Connectivity) クラスは、クラス CDaoDatabase を代わりに使用します。詳細については、" " :概要 データベース プログラミングを参照してください。

CDatabaseを使用し、CDatabase オブジェクトを構築し、OpenEx のメンバー関数を呼び出します。これは、接続を開きます。次に、接続されたデータ ソースの操作の CRecordset のオブジェクトを構築するときに、CDatabase のオブジェクトに、レコードセットのコンストラクターにポインターを渡します。接続を使い終わったら [閉じる] のメンバー関数を呼び出し、CDatabase オブジェクトを破棄します。[閉じる] は、以前に閉じていないレコードセットを閉じます。

CDatabaseに関する詳細については、" " データ ソース (ODBC) と :概要 データベース プログラミングを参照してください。

継承階層

CObject

CDatabase

必要条件

Header: afxdb.h

参照

関連項目

CObject クラス

階層図

CRecordset クラス