CRecordset 類別

發行項
03/15/2013

表示選取自資料來源的資料錄集。

class CRecordset : public CObject

成員

公用建構函式

名稱	描述
CRecordset::CRecordset	建構 CRecordset 物件。您的衍生類別必須提供呼叫這個建構函式。

公用方法

名稱	描述
CRecordset::AddNew	將新資料錄的準備工作。呼叫完成附加的 Update 。
CRecordset::CanAppend	如果新資料錄加入至資料錄集藉由 AddNew 成員函式，傳回非零。
CRecordset::CanBookmark	如果資料錄集支援書籤，傳回非零。
CRecordset::Cancel	取消非同步作業或處理序從第二個執行緒。
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	呼叫以便交換資料 (在兩個方向) 在資料錄集的欄位資料成員和資料來源中的對應資料錄之間。實作資料錄欄位交換 (Record Field Exchange，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	包含指定一個結構化查詢語言 (SQL) WHERE 子句的 CString 。用來篩選選取符合特定準則的記錄而言。
CRecordset::m_strSort	包含指定 ORDER BY SQL 子句的 CString 。用來控制資料錄的排序方式。

備註

稱為「資料錄集，」 CRecordset 物件通常用於兩種形式:動態集和快照集。動態集保持同步與其他使用者所做的資料更新。快照集是資料的靜態檢視。每個表單都代表一個固定的一組資料錄，在開啟檔案時，資料錄集，但是，當您移動至動態集的資料錄時，它會反映其他資料錄集後續對資料錄，讓其他使用者或變更在應用程式中。

注意事項
如果您使用存取資料時使用物件 (DAO) 類別而不是開放式資料庫連接 (ODBC) 類別會使用類別， CDaoRecordset 。如需詳細資訊，請參閱本文概觀:資料庫程式開發。

若要與其中一個使用類型資料錄集，可從 CRecordset通常衍生自特定應用程式的資料錄集類別。資料錄集選取資料來源的資料錄，然後，您可以:

捲動記錄。
更新資料錄並指定一個鎖定模式。
篩選資料錄從這些選取資料來源中可使用的資料錄集限制。
排序資料錄集。
參數化資料錄集自訂其資訊的選項並不知道在執行階段之前。

使用類別，開啟資料庫和建構資料錄集物件，透過建構函式指標至 CDatabase 物件。然後呼叫資料錄集的開啟成員函式，您可以指定物件是否為動態集 (Dynaset) 或快照集 (Snapshot)。呼叫開啟選取資料來源的資料。在開啟後的資料錄集物件，請使用它的成員函式和資料成員可以捲動記錄和會在它們。可用的作業是由物件為動態集 (Dynaset) 或快照集 (Snapshot)，它是否可更新或唯讀 (這取決於開放式資料庫連接 (Open Database Connectivity，ODBC) 資料來源的)，功能，以及您要實作大量資料列擷取。重新整理可能已變更或加入的資料錄，因為開啟呼叫時，呼叫物件的 Requery 成員函式。當您完成使用後，請呼叫物件的成員函式關閉並終結該物件。

在衍生的類別， CRecordset 資料錄欄位交換 (RFX) 或大量資料錄欄位交換 (Bulk RFX) 是用來支援讀取和更新資料錄欄位。

如需資料錄集和資料錄欄位交換的詳細資訊，請參閱 Microsoft 知識庫文件概觀:資料庫程式開發、資料錄集 (ODBC)、資料錄集:擷取大量資料錄 (ODBC)和資料錄欄位交換 (RFX)。如需動態集和快照中的焦點，請參閱 Microsoft 知識庫文件 Dynaset 和快照。