次の方法で共有


CDaoRecordset クラス

データ ソースから選択された 1 組のレコードセットを表現します。

class CDaoRecordset : public CObject

メンバー

8wht5w3w.collapse_all(ja-jp,VS.110).gifパブリック コンストラクター

名前

説明

CDaoRecordset::CDaoRecordset

CDaoRecordset オブジェクトを構築します。

8wht5w3w.collapse_all(ja-jp,VS.110).gifパブリック メソッド

名前

説明

CDaoRecordset::AddNew

新規レコードを追加するための準備。加算を実行します 更新

CDaoRecordset::CanAppend

新しいレコードが AddNew のメンバー関数でレコードセットに追加できる場合はを返します。

CDaoRecordset::CanBookmark

レコードセットがブックマークをサポートする場合は、を返します。

CDaoRecordset::CancelUpdate

AddNew[編集] または操作による保留中の更新をキャンセルします。

CDaoRecordset::CanRestart

レコードセットのクエリを再実行するために [再クエリ] を呼び出すことができる場合はを返します。

CDaoRecordset::CanScroll

レコード間をスクロールできる場合はを返します。

CDaoRecordset::CanTransact

データ ソースがトランザクションをサポートしている場合は、を返します。

CDaoRecordset::CanUpdate

レコードセットが更新できる場合はゼロを返します (レコードを追加、更新、または削除できます)。

CDaoRecordset::Close

レコードセットを閉じます。

CDaoRecordset::Delete

レコードセットの現在のレコードを削除します。削除した後で別のレコードに明示的にスクロールする必要があります。

CDaoRecordset::DoFieldExchange

(両方向に) レコードセットのフィールド データ メンバーとデータ ソース内の対応するレコード間のデータ交換に呼び出されます。実装の DAO レコード フィールド エクスチェンジ (DFX)。

CDaoRecordset::Edit

現在のレコードへの変更の準備。編集を終了します 更新

CDaoRecordset::FillCache

ODBC データ ソースのデータを含むレコードセット オブジェクトのローカル キャッシュすべてまたは一部を塗りつぶします。

CDaoRecordset::Find

指定された基準を満たす探し、ダイナセットに型のレコードセット内の特定の文字列の最初の、を、前または最後の場所を現在のレコードを記録します。

CDaoRecordset::FindFirst

指定された基準を満たす探し、ダイナセットする型またはスナップショット タイプのレコードセットの最初のレコードが現在のレコードを記録します。

CDaoRecordset::FindLast

指定された基準を満たす探し、ダイナセットする型またはスナップショット タイプのレコードセットの最後のレコードが現在のレコードを記録します。

CDaoRecordset::FindNext

指定された基準を満たす探し、ダイナセットする型またはスナップショット タイプのレコードセットの次のレコードが現在のレコードを記録します。

CDaoRecordset::FindPrev

指定された基準を満たす探し、ダイナセットする型またはスナップショット タイプのレコードセットの前のレコードが現在のレコードを記録します。

CDaoRecordset::GetAbsolutePosition

レコードセット オブジェクトのレコード数を返します。

CDaoRecordset::GetBookmark

レコードのブックマークを表す値を返します。

CDaoRecordset::GetCacheSize

ローカルで ODBC データ ソースからキャッシュするデータを含むダイナセット型のレコードセット内のレコード数を指定する値を返します。

CDaoRecordset::GetCacheStart

キャッシュするレコードセットの最初のレコードのブックマークを示す値を返します。

CDaoRecordset::GetCurrentIndex

最新インデックス付きの型テーブル CDaoRecordsetで使用されているインデックスの名前を含む CString を返します。

CDaoRecordset::GetDateCreated

返します CDaoRecordset のオブジェクトの基になるベース テーブルの作成日時

CDaoRecordset::GetDateLastUpdated

行われた CDaoRecordset のオブジェクトの基になるベース テーブルのデザインに対する直前の変更の日時を返します。

CDaoRecordset::GetDefaultDBName

既定のデータ ソースの名前を返します。

CDaoRecordset::GetDefaultSQL

既定の SQL 文字列を実装するために取得するために呼び出されます。

CDaoRecordset::GetEditMode

現在のレコードの編集の状態を示す値を返します。

CDaoRecordset::GetFieldCount

レコードセットのフィールド数を表す値を返します。

CDaoRecordset::GetFieldInfo

特定の種類のレコードセットのフィールドに関する情報を返します。

CDaoRecordset::GetFieldValue

レコードセットのフィールドの値を返します。

CDaoRecordset::GetIndexCount

レコードセットの下にあるテーブル インデックスの数を取得します。

CDaoRecordset::GetIndexInfo

さまざまな種類のインデックスに関する情報を返します。

CDaoRecordset::GetLastModifiedBookmark

最後に、追加または更新されたレコードを特定するために使用します。

CDaoRecordset::GetLockingMode

そのロックの種類は、エディット コンティニュ中に仮想あることを示す値を返します。

CDaoRecordset::GetName

レコードセットの名前を含む CString を返します。

CDaoRecordset::GetParamValue

DAOParameter の基になるオブジェクトに格納されているパラメーター指定の現在の値を取得します。

CDaoRecordset::GetPercentPosition

合計の割合でレコード数として現在のレコードの位置を返します。

CDaoRecordset::GetRecordCount

レコードセット オブジェクトにアクセスするレコード数を返します。

CDaoRecordset::GetSQL

SQL 文字列をレコードセットのレコードを選択するために使用するを取得します。

CDaoRecordset::GetType

レコードセットの型を決定するために呼び出される: テーブル型、型、ダイナセットとスナップショット型。

CDaoRecordset::GetValidationRule

フィールドに入力されたときにデータを検証する値を含む CString を返します。

CDaoRecordset::GetValidationText

検証規則が満たされない場合に表示されるテキストを取得します。

CDaoRecordset::IsBOF

レコードセットが前に、最初のレコード設定以外の値を返します。現在のレコードがありません。

CDaoRecordset::IsDeleted

レコードセットが削除したレコードに配置されている場合は、を返します。

CDaoRecordset::IsEOF

レコードセットが最後のレコードの後で設定された場合は、を返します。現在のレコードがありません。

CDaoRecordset::IsFieldDirty

現在のレコードのフィールドが変更された場合は、を返します。

CDaoRecordset::IsFieldNull

現在のレコードのフィールドが null の場合はを返し、値はです (なし)。

CDaoRecordset::IsFieldNullable

現在のレコードのフィールドに NULL に設定できます以外の値を返し (値を持つ場合)。

CDaoRecordset::IsOpen

[開く] が前に呼び出された場合は、を返します。

CDaoRecordset::Move

どちらの方向にも現在のレコードから指定されたレコードの数にレコードセットを設定します。

CDaoRecordset::MoveFirst

レコードセットの最初のレコードが現在のレコードを設定します。

CDaoRecordset::MoveLast

レコードセットの最後のレコードが現在のレコードを設定します。

CDaoRecordset::MoveNext

レコードセットの次のレコードが現在のレコードを設定します。

CDaoRecordset::MovePrev

レコードセットのレコードの前に現在のレコードを設定します。

CDaoRecordset::Open

テーブル、ダイナセットとスナップショットから新しいレコードセットを作成します。

CDaoRecordset::Requery

レコードセットのクエリを指定のレコードを更新するに再度実行します。

CDaoRecordset::Seek

現在のインデックスに指定された条件を満たす探し、インデックス付きの型テーブルにレコードセット オブジェクトのレコードが現在のレコードを記録します。

CDaoRecordset::SetAbsolutePosition

レコードセット オブジェクトのレコード数を設定します。

CDaoRecordset::SetBookmark

指定したブックマークを含むレコードをレコードセットに設定します。

CDaoRecordset::SetCacheSize

ローカルで ODBC データ ソースからキャッシュするデータを含むダイナセット型のレコードセット内のレコード数を指定する値を設定します。

CDaoRecordset::SetCacheStart

キャッシュするレコードセットの最初のレコードのブックマークを指定する値を設定します。

CDaoRecordset::SetCurrentIndex

テーブル タイプのレコードセットのインデックスが設定されます。

CDaoRecordset::SetFieldDirty

変更されるように現在のレコードのフィールドをマークします。

CDaoRecordset::SetFieldNull

Null に現在のレコードのフィールドの値を設定します (値を持つ場合)。

CDaoRecordset::SetFieldValue

レコードセットのフィールドの値を設定します。

CDaoRecordset::SetFieldValueNull

Null にレコードセットのフィールドの値を設定します。(値を持つ場合)。

CDaoRecordset::SetLockingMode

エディット中に実行するロックの種類を示す値を設定します。

CDaoRecordset::SetParamValue

DAOParameter の基になるオブジェクトに格納されているパラメーター指定の現在の値を設定します

CDaoRecordset::SetParamValueNull

Null に指定されたパラメーターの現在の値を設定します (値を持つ場合)。

CDaoRecordset::SetPercentPosition

レコードセットの割合としておけるレコードの総数に対応する場所に現在のレコードの位置を設定します。

CDaoRecordset::Update

データ ソースの新規または編集されたデータを保存して AddNew または [編集] 操作を完了します。

8wht5w3w.collapse_all(ja-jp,VS.110).gifパブリック データ メンバー

名前

説明

CDaoRecordset::m_bCheckCacheForDirtyFields

フィールドが変更されるように自動的にマークされているかどうかを示すフラグが含まれます。

CDaoRecordset::m_nFields

レコードセット クラスでフィールド データ メンバーの数と、データ ソースからレコードセット オブジェクトによって選択された列数が含まれます。

CDaoRecordset::m_nParams

レコードセット クラス—レコードセットのクエリで渡されるパラメーターの数のパラメーター データ メンバーの数。

CDaoRecordset::m_pDAORecordset

レコードセット オブジェクトの下にある DAO インターフェイスへのポインター。

CDaoRecordset::m_pDatabase

この結果セットのソース データベース。CDaoDatabase のオブジェクトへのポインターが格納されます。

CDaoRecordset::m_strFilter

SQL の WHERE のステートメントの構築に使用される文字列が含まれています。

CDaoRecordset::m_strSort

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)。また GetFieldValueSetFieldValueを使用して DFX 機構を使用せずにデータベース列の動的な連結を実行できます。

関連情報は、DAO ヘルプ トピック「レコードセット オブジェクト」を参照してください。

継承階層

CObject

CDaoRecordset

必要条件

Header: afxdao.h

参照

関連項目

CObject クラス

階層図

CDaoTableDef クラス

CDaoWorkspace クラス

CDaoDatabase クラス

CDaoQueryDef クラス