CDaoRecordset クラス
データ ソースから選択された 1 組のレコードセットを表現します。
class CDaoRecordset : public CObject
メンバー
パブリック コンストラクター
名前 |
説明 |
---|---|
CDaoRecordset オブジェクトを構築します。 |
パブリック メソッド
名前 |
説明 |
---|---|
新規レコードを追加するための準備。加算を実行します 更新。 |
|
新しいレコードが AddNew のメンバー関数でレコードセットに追加できる場合はを返します。 |
|
レコードセットがブックマークをサポートする場合は、を返します。 |
|
レコードセットのクエリを再実行するために [再クエリ] を呼び出すことができる場合はを返します。 |
|
レコード間をスクロールできる場合はを返します。 |
|
データ ソースがトランザクションをサポートしている場合は、を返します。 |
|
レコードセットが更新できる場合はゼロを返します (レコードを追加、更新、または削除できます)。 |
|
レコードセットを閉じます。 |
|
レコードセットの現在のレコードを削除します。削除した後で別のレコードに明示的にスクロールする必要があります。 |
|
(両方向に) レコードセットのフィールド データ メンバーとデータ ソース内の対応するレコード間のデータ交換に呼び出されます。実装の DAO レコード フィールド エクスチェンジ (DFX)。 |
|
現在のレコードへの変更の準備。編集を終了します 更新。 |
|
ODBC データ ソースのデータを含むレコードセット オブジェクトのローカル キャッシュすべてまたは一部を塗りつぶします。 |
|
指定された基準を満たす探し、ダイナセットに型のレコードセット内の特定の文字列の最初の、を、前または最後の場所を現在のレコードを記録します。 |
|
指定された基準を満たす探し、ダイナセットする型またはスナップショット タイプのレコードセットの最初のレコードが現在のレコードを記録します。 |
|
指定された基準を満たす探し、ダイナセットする型またはスナップショット タイプのレコードセットの最後のレコードが現在のレコードを記録します。 |
|
指定された基準を満たす探し、ダイナセットする型またはスナップショット タイプのレコードセットの次のレコードが現在のレコードを記録します。 |
|
指定された基準を満たす探し、ダイナセットする型またはスナップショット タイプのレコードセットの前のレコードが現在のレコードを記録します。 |
|
レコードセット オブジェクトのレコード数を返します。 |
|
レコードのブックマークを表す値を返します。 |
|
ローカルで ODBC データ ソースからキャッシュするデータを含むダイナセット型のレコードセット内のレコード数を指定する値を返します。 |
|
キャッシュするレコードセットの最初のレコードのブックマークを示す値を返します。 |
|
最新インデックス付きの型テーブル CDaoRecordsetで使用されているインデックスの名前を含む CString を返します。 |
|
返します CDaoRecordset のオブジェクトの基になるベース テーブルの作成日時 |
|
行われた CDaoRecordset のオブジェクトの基になるベース テーブルのデザインに対する直前の変更の日時を返します。 |
|
既定のデータ ソースの名前を返します。 |
|
既定の SQL 文字列を実装するために取得するために呼び出されます。 |
|
現在のレコードの編集の状態を示す値を返します。 |
|
レコードセットのフィールド数を表す値を返します。 |
|
特定の種類のレコードセットのフィールドに関する情報を返します。 |
|
レコードセットのフィールドの値を返します。 |
|
レコードセットの下にあるテーブル インデックスの数を取得します。 |
|
さまざまな種類のインデックスに関する情報を返します。 |
|
最後に、追加または更新されたレコードを特定するために使用します。 |
|
そのロックの種類は、エディット コンティニュ中に仮想あることを示す値を返します。 |
|
レコードセットの名前を含む CString を返します。 |
|
DAOParameter の基になるオブジェクトに格納されているパラメーター指定の現在の値を取得します。 |
|
合計の割合でレコード数として現在のレコードの位置を返します。 |
|
レコードセット オブジェクトにアクセスするレコード数を返します。 |
|
SQL 文字列をレコードセットのレコードを選択するために使用するを取得します。 |
|
レコードセットの型を決定するために呼び出される: テーブル型、型、ダイナセットとスナップショット型。 |
|
フィールドに入力されたときにデータを検証する値を含む CString を返します。 |
|
検証規則が満たされない場合に表示されるテキストを取得します。 |
|
レコードセットが前に、最初のレコード設定以外の値を返します。現在のレコードがありません。 |
|
レコードセットが削除したレコードに配置されている場合は、を返します。 |
|
レコードセットが最後のレコードの後で設定された場合は、を返します。現在のレコードがありません。 |
|
現在のレコードのフィールドが変更された場合は、を返します。 |
|
現在のレコードのフィールドが null の場合はを返し、値はです (なし)。 |
|
現在のレコードのフィールドに NULL に設定できます以外の値を返し (値を持つ場合)。 |
|
[開く] が前に呼び出された場合は、を返します。 |
|
どちらの方向にも現在のレコードから指定されたレコードの数にレコードセットを設定します。 |
|
レコードセットの最初のレコードが現在のレコードを設定します。 |
|
レコードセットの最後のレコードが現在のレコードを設定します。 |
|
レコードセットの次のレコードが現在のレコードを設定します。 |
|
レコードセットのレコードの前に現在のレコードを設定します。 |
|
テーブル、ダイナセットとスナップショットから新しいレコードセットを作成します。 |
|
レコードセットのクエリを指定のレコードを更新するに再度実行します。 |
|
現在のインデックスに指定された条件を満たす探し、インデックス付きの型テーブルにレコードセット オブジェクトのレコードが現在のレコードを記録します。 |
|
レコードセット オブジェクトのレコード数を設定します。 |
|
指定したブックマークを含むレコードをレコードセットに設定します。 |
|
ローカルで ODBC データ ソースからキャッシュするデータを含むダイナセット型のレコードセット内のレコード数を指定する値を設定します。 |
|
キャッシュするレコードセットの最初のレコードのブックマークを指定する値を設定します。 |
|
テーブル タイプのレコードセットのインデックスが設定されます。 |
|
変更されるように現在のレコードのフィールドをマークします。 |
|
Null に現在のレコードのフィールドの値を設定します (値を持つ場合)。 |
|
レコードセットのフィールドの値を設定します。 |
|
Null にレコードセットのフィールドの値を設定します。(値を持つ場合)。 |
|
エディット中に実行するロックの種類を示す値を設定します。 |
|
DAOParameter の基になるオブジェクトに格納されているパラメーター指定の現在の値を設定します |
|
Null に指定されたパラメーターの現在の値を設定します (値を持つ場合)。 |
|
レコードセットの割合としておけるレコードの総数に対応する場所に現在のレコードの位置を設定します。 |
|
データ ソースの新規または編集されたデータを保存して AddNew または [編集] 操作を完了します。 |
パブリック データ メンバー
名前 |
説明 |
---|---|
フィールドが変更されるように自動的にマークされているかどうかを示すフラグが含まれます。 |
|
レコードセット クラスでフィールド データ メンバーの数と、データ ソースからレコードセット オブジェクトによって選択された列数が含まれます。 |
|
レコードセット クラス—レコードセットのクエリで渡されるパラメーターの数のパラメーター データ メンバーの数。 |
|
レコードセット オブジェクトの下にある DAO インターフェイスへのポインター。 |
|
この結果セットのソース データベース。CDaoDatabase のオブジェクトへのポインターが格納されます。 |
|
SQL の WHERE のステートメントの構築に使用される文字列が含まれています。 |
|
SQL の ORDER BY のステートメントの構築に使用される文字列が含まれています。 |
解説
「レコードセットと呼ばれる」、CDaoRecordset のオブジェクトには、次の 3 とおりの形式にあります:
テーブル タイプのレコードセットは、一つのデータベース テーブルからレコードをチェックするか、追加、変更、または削除するために使用できるベース テーブルを表します。
レコードセットが更新可能なダイナセット型のレコードを変更できるクエリの結果です。これらのレコードセットは、基になるテーブルからレコードをチェックするか、追加、変更、または削除するために使用できる一連のレコードになります。レコードセットがダイナセット型のデータベースで一つ以上のテーブルのフィールドを含めることができます。
スナップショット タイプのレコードセットでは、データを検索するか、またはレポートを生成するために使用できる一連のレコードの静的なコピーです。これらのレコードセットは、データベースに一つ以上のテーブルのフィールドを含めることができますが、更新できません。
レコードセットの各フォームは、レコードセットを開いたときに修正レコードを表します。テーブルのレコードセットがダイナセット型または型のレコードセットのレコードにスクロールすると、レコードセットが他のユーザーまたはアプリケーションの他のレコードセットによって、開いた後で行われたレコードへの変更を反映します。(A のスナップショット タイプのレコードセットを更新できません)。CDaoRecordset を直接使用するか、CDaoRecordsetからアプリケーション固有のレコードセット クラスを派生させることができます。この場合、次のいずれかの操作を行うことができます。
レコードをスクロールします。
インデックスを設定し、[シーク] (テーブル タイプのレコードセットのみ) を使用してすぐにレコードを検索します。
文字列比較に基づいてレコードを検索する: "<"、"<="、"="、">="、または ">" 型 (ダイナセットとスナップショット タイプのレコードセット)。
レコードを更新し、ロック モードを指定します (スナップショット タイプのレコードセットを除く)。
制約するには、レコードがデータ ソースで使用可能なから、選択したレコードセットをフィルター処理します。
レコードセットを並べ替える。
実行時までわからない情報を含むオプションをカスタマイズするには、レコードセットのパラメーター化します。
CDaoRecordset の指定を CRecordsetクラスに似たインターフェイス並べ替える。主な違いは、データ アクセス、クラスの CDaoRecordset Access データが OLE オブジェクトに基づいて (DAO) にすることです。クラス CRecordset は、ODBC (Open Database Connectivity) と、DBMS の ODBC ドライバーを通じて DBMS にアクセスします。
[!メモ]
DAO データベース クラスは、ODBC (Open Database Connectivity) に基づく MFC データベース クラスとは異なります。すべての DAO データベース クラス名に「CDao」が付きます。まだ DAO クラスと ODBC データ ソースにアクセスできます; DAO クラスは、一般に Microsoft Jet データベース エンジンに固有であるため、優れた機能を提供します。
CDaoRecordset を直接使用するか、CDaoRecordsetからクラスを派生させることができます。レコードセット クラスのどちらでも使用し、データベースを開き、CDaoDatabase のオブジェクトへのポインターをコンストラクターに渡してレコードセット オブジェクトを構築する。また CDaoRecordset のオブジェクトを作成し、MFC は、の CDaoDatabase の一時的なオブジェクトを作成できます。その後、オブジェクトがテーブル タイプのレコードセット、ダイナセット型のレコードセット、またはスナップショット タイプのレコードセットかどうかを指定する [開く] のレコードセットのメンバー関数を呼び出します。[開く] を呼び出すと、データベースのデータを選択し、最初のレコードを取得します。
オブジェクトのメンバー関数とデータ メンバーをスクロールするレコードを利用して動作します。操作の一つに、オブジェクトがテーブル タイプのレコードセット、ダイナセット型のレコードセット、またはスナップショット タイプのレコードセットであるか、および更新可能または読み取り専用かどうかによって異なります。これは、データベース ODBC (Open Database Connectivity) データ ソースの機能に依存することができます。[開く] の呼び出しが、オブジェクトの [再クエリ] のメンバー関数を呼び出すため変更または追加される可能性があるレコードを更新します。処理を終了するときのオブジェクトの [閉じる] のメンバー関数を呼び出して、オブジェクトを破棄します。
の CDaoRecordset、または CDaoRecordset派生クラスのタイプ セーフな C++ のメンバーを使用してレコード フィールドの読み取りと更新の 使用をサポートするCDaoRecordset DAO レコード フィールド エクスチェンジ (DFX)。また GetFieldValue と SetFieldValueを使用して DFX 機構を使用せずにデータベース列の動的な連結を実行できます。
関連情報は、DAO ヘルプ トピック「レコードセット オブジェクト」を参照してください。
継承階層
CDaoRecordset
必要条件
Header: afxdao.h