CDaoDatabase クラス

それを通じてデータを操作することのできるデータベースへの接続を表します。

class CDaoDatabase : public CObject

メンバー

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

名前	説明
CDaoDatabase::CDaoDatabase	CDaoDatabase オブジェクトを構築します。オブジェクトをデータベースに接続するに [開く] を呼び出します。

パブリック メソッド

名前	説明
CDaoDatabase::CanTransact	ゼロ以外のデータベース サポートのトランザクションを返します。
CDaoDatabase::CanUpdate	CDaoDatabase のオブジェクトが更新可能である場合は、を返します (読み取り専用)。
CDaoDatabase::Close	データベース接続を閉じます。
CDaoDatabase::Create	基になる DAO のデータベース オブジェクトを作成し、CDaoDatabase のオブジェクトを初期化します。
CDaoDatabase::CreateRelation	新しいデータベースのテーブル間の関係を定義します。
CDaoDatabase::DeleteQueryDef	データベースの QueryDefs のコレクションに保存される querydef オブジェクトを削除します。
CDaoDatabase::DeleteRelation	データベースのテーブル間の既存の関係を削除します。
CDaoDatabase::DeleteTableDef	データベース テーブルの定義を削除します。これは実際のテーブルとデータをすべて削除します。
CDaoDatabase::Execute	アクション クエリを実行します。結果は例外を返すクエリの [実行] を呼び出します。
CDaoDatabase::GetConnect	データベースへの CDaoDatabase のオブジェクトを接続するために使用される接続文字列を返します。ODBC に使用されます。
CDaoDatabase::GetName	現在使用中のデータベースの名前を返します。
CDaoDatabase::GetQueryDefCount	データベースに対して定義されているクエリの数を返します。
CDaoDatabase::GetQueryDefInfo	データベースで定義された、指定されたクエリに関する情報を返します。
CDaoDatabase::GetQueryTimeout	秒数を返します。その場合、データベースのクエリ操作はタイムアウトします。以降の影響を開いてに対して、[実行] の呼び出しなど、ODBC データ ソースの新規および更新および編集操作などの操作 (のみ) を追加します。
CDaoDatabase::GetRecordsAffected	最後の更新、編集の影響を受けたレコードの数を返すか、呼び出しによって [実行]に操作またはを追加します。
CDaoDatabase::GetRelationCount	データベースのテーブルの間で定義されている関係の数を返します。
CDaoDatabase::GetRelationInfo	データベースのテーブルの間で定義されている関係に関する情報を返します。
CDaoDatabase::GetTableDefCount	データベースで定義されたテーブルの数を返します。
CDaoDatabase::GetTableDefInfo	データベース テーブルの指定に関する情報を返します。
CDaoDatabase::GetVersion	データベースに関連付けられたデータベース エンジンのバージョンを返します。
CDaoDatabase::IsOpen	データベースへの CDaoDatabase のオブジェクトが現在接続された場合、を返します。
CDaoDatabase::Open	データベースへの接続を確立します。
CDaoDatabase::SetQueryTimeout	秒数を設定します。その場合、データベースのクエリ操作は ODBC データ ソース (のみ) タイムアウトします。以降の影響を開いてに対して、新しい更新、および削除の各操作を追加します。

パブリック データ メンバー

名前	説明
CDaoDatabase::m_pDAODatabase	基になる DAO データベース オブジェクトへのポインター。
CDaoDatabase::m_pWorkspace	データベースが含まれ、トランザクションの領域を定義する CDaoWorkspace オブジェクトへのポインター。

解説

サポートされているデータベース形式の詳細については、GetName のメンバー関数に関するトピックを参照してください。」、CDaoWorkspace のオブジェクトによって表される特定の「ワークスペースの CDaoDatabase の一つ以上のオブジェクトをアクティブに一度に指定できます。ワークスペースと呼ばれる開いているデータベース オブジェクトのコレクション データベースのコレクションを保持します。

[!メモ]

MFC DAO データベース クラスは、ODBC に基づいて MFC データベース クラスとは異なります。すべての DAO データベース クラス名に「CDao」が付きます。クラス CDaoDatabase は ODBC クラス CDatabaseに似たインターフェイスを提供します。主な違いは CDatabase が ODBC (Open Database Connectivity) と、DBMS の ODBC ドライバーを通じて DBMS にアクセスすることです。データ アクセスでCDaoDatabase のアクセスのデータは、Microsoft Jet データベース エンジンに基づいて (DAO) について説明します。一般に、に基づく MFC DAO クラスは、ODBC (DAO クラスより;できます。DAO ベースのクラスには独自のデータベース エンジンで ODBC ドライバーを通じて、含むデータにアクセスできます。DAO ベースのクラスは、クラスによって DAO を直接呼び出さないでテーブルの追加など、データ定義言語の (DDL)、操作をサポートします。

使用方法

レコードセット オブジェクトを作成するときにデータベース オブジェクトを暗黙的に作成できます。ただし、データベース オブジェクトを明示的に作成できます。CDaoDatabaseと、既存のデータベースを明示的に使用するには、次のいずれかを実行する:

• CDaoWorkspace の開いているオブジェクトへのポインターを渡す CDaoDatabase のオブジェクトを構築します。

• またはワークスペースを指定せずに CDaoDatabase のオブジェクトを構築します (MFC は一時的なワークスペース オブジェクトを作成します。

新しい Microsoft Jet (.mdb) データベースを作成し、CDaoDatabase オブジェクトを構築し、[作成] のメンバー関数を呼び出します。**[作成]**の後に [開く] を呼び出さないでください。

既存のデータベースを開き、CDaoDatabase オブジェクトを構築し、[開く] のメンバー関数を呼び出します。

これらの方法のいずれかにワークスペースのコレクション データベースへの DAO データベース オブジェクトを追加し、データへの接続を開きます。次に、接続されたデータベースの操作の CDaoRecordset、CDaoTableDef、または CDaoQueryDef のオブジェクトを構築するときに、CDaoDatabase のオブジェクトにオブジェクトのコンストラクターにポインターを渡します。接続を使い終わったら [閉じる] のメンバー関数を呼び出し、CDaoDatabase オブジェクトを破棄します。[閉じる] は、以前に閉じていないレコードセットを閉じます。

トランザクション

データベースのトランザクション処理では、ワークスペースのレベルで指定されています。CDaoWorkspaceクラスの BeginTrans、CommitTransと [ロールバック] のメンバー関数を参照してください。

ODBC 接続

ODBC データ ソースを使用する方法は、Microsoft Jet (.mdb) データベースへの外部テーブルをアタッチできます。

コレクション

各データベースは、tabledef querydef、レコードセットと関係のオブジェクトの独自のコレクションを保持します。クラス CDaoDatabase はこれらのオブジェクトを操作するためのメンバー関数を提供します。

[!メモ]

オブジェクトは、DAO ではなく、MFC データベース オブジェクトに格納されます。MFC は、tabledef、querydef とレコードセット オブジェクトの関係のないオブジェクトのクラスを提供します。

継承階層

CObject

CDaoDatabase

必要条件

Header: afxdao.h

参照

関連項目

CObject クラス

階層図

CDaoWorkspace クラス

CDaoRecordset クラス

CDaoTableDef クラス

CDaoQueryDef クラス

CDatabase クラス

CDaoException クラス