CRecordset クラス

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

class CRecordset : public CObject

メンバー

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

名前	説明
CRecordset::CRecordset	CRecordset オブジェクトを構築します。また、派生クラスはこの 1 を呼び出すコンストラクターを提供する必要があります。

パブリック メソッド

名前	説明
CRecordset::AddNew	新規レコードを追加するための準備。加算を実行します Update。
CRecordset::CanAppend	新しいレコードが AddNew のメンバー関数でレコードセットに追加できる場合はを返します。
CRecordset::CanBookmark	レコードセットがブックマークをサポートする場合は、を返します。
CRecordset::Cancel	2 番目のスレッドからの非同期操作またはプロセスを取り消します。
CRecordset::CancelUpdate	AddNew または Edit 操作による保留中の更新をキャンセルします。
CRecordset::CanRestart	レコードセットのクエリを再実行するために Requery を呼び出すことができる場合はを返します。
CRecordset::CanScroll	レコード間をスクロールできる場合はを返します。
CRecordset::CanTransact	データ ソースがトランザクションをサポートしている場合は、を返します。
CRecordset::CanUpdate	レコードセットが更新できる場合はゼロを返します (レコードを追加、更新、または削除できます)。
CRecordset::CheckRowsetError	レコードのフェッチ中に発生するエラーを処理するために呼び出されます。
CRecordset::Close	それに関連付けられたレコードセットと ODBC HSTMT を閉じます。
CRecordset::Delete	レコードセットの現在のレコードを削除します。削除した後で別のレコードに明示的にスクロールする必要があります。
CRecordset::DoBulkFieldExchange	データ ソースからレコードセット オブジェクトに複数行のデータを交換するために呼び出されます。バルク レコード フィールド エクスチェンジ (Bulk RFX) を実装します。
CRecordset::DoFieldExchange	(両方向に) レコードセットのフィールド データ メンバーとデータ ソース内の対応するレコード間のデータ交換に呼び出されます。実装のレコード フィールド エクスチェンジ (RFX)。
CRecordset::Edit	現在のレコードへの変更の準備。編集を終了します Update。
CRecordset::FlushResultSet	定義済みのクエリを使用するときに取得する別の結果セットがある場合は、を返します。
CRecordset::GetBookmark	パラメーター オブジェクトにレコードのブックマークの値を割り当てます。
CRecordset::GetDefaultConnect	既定の接続文字列を取得するために呼び出されます。
CRecordset::GetDefaultSQL	既定の SQL 文字列を実装するために取得するために呼び出されます。
CRecordset::GetFieldValue	レコードセットのフィールドの値を返します。
CRecordset::GetODBCFieldCount	レコードセットのフィールドの数を返します。
CRecordset::GetODBCFieldInfo	特定の種類のレコードセットのフィールドに関する情報を返します。
CRecordset::GetRecordCount	レコードセットのレコード数を返します。
CRecordset::GetRowsetSize	、単一のフェッチで取得するレコード数を返します。
CRecordset::GetRowsFetched	フェッチで取得される実際の行数を返します。
CRecordset::GetRowStatus	フェッチの後に行の状態を返します。
CRecordset::GetSQL	SQL 文字列をレコードセットのレコードを選択するために使用するを取得します。
CRecordset::GetStatus	レコードセットの状態を取得します: レコードの最終的な計算が派生したかどうか、および現在のレコードのインデックス。
CRecordset::GetTableName	レコードセットが基づいたテーブルの名前を取得します。
CRecordset::IsBOF	レコードセットが前に、最初のレコード設定以外の値を返します。現在のレコードがありません。
CRecordset::IsDeleted	レコードセットが削除したレコードに配置されている場合は、を返します。
CRecordset::IsEOF	レコードセットが最後のレコードの後で設定された場合は、を返します。現在のレコードがありません。
CRecordset::IsFieldDirty	現在のレコードのフィールドが変更された場合は、を返します。
CRecordset::IsFieldNull	現在のレコードのフィールドに null の場合はを返します (値がありません)。
CRecordset::IsFieldNullable	現在のレコードのフィールドに null に設定できます以外の値を返し (値を持つ場合)。
CRecordset::IsOpen	Open が前に呼び出された場合は、を返します。
CRecordset::Move	どちらの方向にも現在のレコードから指定されたレコードの数にレコードセットを設定します。
CRecordset::MoveFirst	レコードセットの最初のレコードが現在のレコードを設定します。最初に IsBOF のテスト。
CRecordset::MoveLast	最後のレコードまたは最後の行セット内の現在のレコードを設定します。最初に IsEOF のテスト。
CRecordset::MoveNext	次のレコードまたは行セットに次の現在のレコードを設定します。最初に IsEOF のテスト。
CRecordset::MovePrev	前のレコードまたは行セットの前に現在のレコードを設定します。最初に IsBOF のテスト。
CRecordset::OnSetOptions	指定した ODBC ステートメントのオプション (選択範囲で使用されている) を設定するために呼び出されます。
CRecordset::OnSetUpdateOptions	指定した ODBC ステートメントのオプション (更新で使用される) 設定するために呼び出されます。
CRecordset::Open	テーブルを取得するか、レコードセットを表すクエリを実行すると、レコードセットを開きます。
CRecordset::RefreshRowset	指定された列のデータとステータスを更新します。
CRecordset::Requery	レコードセットのクエリを指定のレコードを更新するに再度実行します。
CRecordset::SetAbsolutePosition	指定されたレコード番号に対応するレコードでレコードセットを設定します。
CRecordset::SetBookmark	ブックマークによって指定されるレコードのレコードセットを設定します。
CRecordset::SetFieldDirty	変更されるように現在のレコードのフィールドをマークします。
CRecordset::SetFieldNull	null 値が現在のレコードのフィールドの値を設定します (値を持つ場合)。
CRecordset::SetLockingMode	「楽観的なロック」 (既定値) または「悲観的な」ロックにロック モードを設定します。レコードが更新プログラムに対してロックされているかを判定します。
CRecordset::SetParamNull	指定したパラメーターを null に設定します (値を持つ場合)。
CRecordset::SetRowsetCursorPosition	行セット内の指定した行にカーソルが移動します。
CRecordset::SetRowsetSize	、フェッチで取得するレコード数を指定します。
CRecordset::Update	データ ソースの新規または編集されたデータを保存して AddNew または Edit 操作を完了します。

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

名前	説明
CRecordset::m_hstmt	レコードセットの ODBC ステートメントのハンドルが含まれます。「HSTMT」と入力します。
CRecordset::m_nFields	レコードセットのフィールド データ メンバーの数が含まれます。「UINT」と入力します。
CRecordset::m_nParams	レコードセットのパラメーター データ メンバーの数が含まれます。「UINT」と入力します。
CRecordset::m_pDatabase	レコードセットがデータ ソースに接続されて CDatabase のオブジェクトへのポインターが格納されます。
CRecordset::m_strFilter	CString が含まれます (Structured Query Language (SQL) WHERE の句を指定できます。特定の条件を満たすそのレコードだけを選択するために使用されるように、フィルター。
CRecordset::m_strSort	CString が含まれます ORDER BY SQL の句を指定できます。レコードを並べ替える方法を制御するために使用します。

解説

「レコードセットと呼ばれる」、CRecordset のオブジェクトは、2 とおりの形式でよく使用されています: ダイナセットとスナップショット。ダイナセットは、他のユーザーによるデータの更新と同期されます。スナップショットは、データの静的なビューです。各フォームはレコードセットを開くと、ダイナセットのレコードにスクロールすると修正レコードを表し、レコードに従って、他のユーザーまたはそのほかのレコードセットによって行われた、アプリケーションの変更を反映する。

[!メモ]

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

レコードセット複数の種類のいずれかを使用するには CRecordsetからそのアプリケーション固有のレコードセット クラスを取得します。レコードセットは、データ ソースからレコードを選択し、次にあります:

• レコードをスクロールします。

• レコードを更新し、ロック モードを指定します。

• 制約するには、レコードがデータ ソースで使用可能なから、選択したレコードセットをフィルター処理します。

• レコードセットを並べ替える。

• 実行時までわからない情報を含むオプションをカスタマイズするには、レコードセットのパラメーター化します。

このクラスを使用して、データベースを開き、CDatabase のオブジェクトへのポインターをコンストラクターに渡してレコードセット オブジェクトを構築する。このオブジェクトは、ダイナセットとスナップショットのどちらであるかを指定できるの [開く] レコードセットのメンバー関数を呼び出します。[開く] を呼び出すと、データ ソースのデータを選択します。レコードセット オブジェクトを開いた後、レコード間をスクロールし、それらを操作するには、メンバー関数とデータ メンバーを使用します。演算を使用可能かどうかは更新可能または読み取り専用かどうか (オブジェクトがダイナセットとスナップショットのどちらであるかによって異なります、バルク行フェッチを実装しているかどうかこれは、ODBC (Open Database Connectivity) データ ソース) 機能によって、異なります。[開く] の呼び出しが、オブジェクトの [再クエリ] のメンバー関数を呼び出すため変更または追加される可能性があるレコードを更新します。処理を終了するときのオブジェクトの [閉じる] のメンバー関数を呼び出して、オブジェクトを破棄します。

CRecordset の派生クラスでは、レコード フィールドの読み取りと更新をサポートするために、レコード フィールド エクスチェンジ (RFX) またはバルク レコード フィールド エクスチェンジ (Bulk RFX) が使用されます。

レコードセットとレコード フィールド エクスチェンジに関する詳細については、" " :概要 データベース プログラミング、レコードセット (ODBC)、レコードセット: フェッチ サイズのレコードを (ODBC)と レコード フィールド エクスチェンジ (RFX)を参照してください。ダイナセットとスナップショットのフォーカスについては、" " [ダイナセット] と [スナップショット]を参照してください。

継承階層

CObject

CRecordset

必要条件

Header: afxdb.h

参照

関連項目

CObject クラス

階層図

CDatabase クラス

CRecordView クラス