CDatabase クラス
データ ソースへの接続を表します。これを通じてデータ ソース上で操作を行うことができます。
class CDatabase : public CObject
メンバー
パブリック コンストラクター
名前 |
説明 |
|---|---|
CDatabase オブジェクトを構築します。 OpenEx か [開く]を呼び出してオブジェクトを初期化する必要があります。 |
パブリック メソッド
名前 |
説明 |
|---|---|
—接続されたデータ ソースのトランザクション「…」— CRecordset クラスの AddNew、[編集]、[削除]と 更新 のメンバー関数に一連の呼び出し元の開始します。 データ ソースは効果が得られるように BeginTrans のトランザクションをサポートする必要があります。 |
|
割り当て CDatabase::ExecuteSQLを呼び出す前にパラメーターへのバインド。 |
|
2 番目のスレッドからの非同期操作またはプロセスを取り消します。 |
|
データ ソースがトランザクションをサポートしている場合は、を返します。 |
|
CDatabase のオブジェクトが更新可能である場合は、を返します (読み取り専用)。 |
|
データ ソースの接続を閉じます。 |
|
BeginTransによって開始されたトランザクションが終了します。 データ ソースを変更するトランザクションのコマンドが実行されます。 |
|
SQL ステートメントを実行します。 データ レコードは返されません。 |
|
ブックマークがレコードセット オブジェクトを永続化する操作を識別します。 |
|
データ ソースへの CDatabase のオブジェクトを接続するために使用される ODBC 接続文字列を返します。 |
|
開いているレコードセット オブジェクトに対するトランザクションをコミット効果を識別します。 |
|
開いているレコードセット オブジェクトのトランザクションをロールバック効果を識別します。 |
|
現在使用中のデータベースの名前を返します。 |
|
データ ソースへの CDatabase のオブジェクトが現在接続された場合、を返します。 |
|
標準的な接続オプションを設定するために、フレームワークによって呼び出されます。 既定の実装では、クエリ タイムアウト値を設定します。 SetQueryTimeoutを呼び出して、これらのオプションを事前に設定できます。 |
|
データ ソースへの接続を確立します (ODBC ドライバーを通じて) |
|
データ ソースへの接続を確立します (ODBC ドライバーを通じて) |
|
現在のトランザクション中に行われた逆の変更。 データ ソースが変更 BeginTrans の呼び出しで定義される前の状態にを返します。 |
|
秒数を設定します。その場合、データ ソースの接続の試みはタイムアウトします。 |
|
秒数を設定します。その場合、データベースのクエリ操作はタイムアウトします。 以降のレコードセット [開く]、AddNew、[編集]と [削除] の呼び出しに適用されます。 |
パブリック データ メンバー
名前 |
説明 |
|---|---|
データ ソースの 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) と :概要 データベース プログラミングを参照してください。
継承階層
CDatabase
必要条件
Header: afxdb.h