CDaoRecordset 類別

發行項
02/28/2013

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

class CDaoRecordset : public CObject

Members

公用建構函式

名稱	描述
CDaoRecordset::CDaoRecordset	建構 CDaoRecordset 物件。

公用方法

名稱	描述
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	傳回包含索引的名稱 CString 最近使用索引，此資料表的型別 CDaoRecordset。
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	呼叫以決定資料錄集類型:資料表類型，動態集 (Dynaset) 或快照集的型別。
CDaoRecordset::GetValidationRule	傳回包含驗證資料值的 CString ，會在欄位中輸入。
CDaoRecordset::GetValidationText	擷取顯示的文字，當驗證規則不滿意。
CDaoRecordset::IsBOF	如果資料錄集的位置後，在第一個資料錄之前，傳回非零。沒有目前資料錄。
CDaoRecordset::IsDeleted	如果資料錄集在已刪除的記錄，放置傳回非零。
CDaoRecordset::IsEOF	如果資料錄集在最後一筆資料錄後，將其放置傳回非零。沒有目前資料錄。
CDaoRecordset::IsFieldDirty	如果已變更，則會傳回非零的目前資料錄中指定的欄位。
CDaoRecordset::IsFieldNull	傳回非零，如果目前的資料錄中指定的欄位是空的 (沒有值)。
CDaoRecordset::IsFieldNullable	傳回非零，如果目前的資料錄中指定的欄位可設為 null (沒有值)。
CDaoRecordset::IsOpen	如果開啟之前，呼叫會傳回零。
CDaoRecordset::Move	將資料錄集至指定的資料錄數目 (從目前資料錄的在任一方向。
CDaoRecordset::MoveFirst	在資料錄集中的第一筆資料錄上目前的資料錄。
CDaoRecordset::MoveLast	在資料錄集的最後一筆資料錄上目前的資料錄。
CDaoRecordset::MoveNext	在資料錄集中的下一筆資料錄上目前的資料錄。
CDaoRecordset::MovePrev	在資料錄集中的一項記錄中目前的資料錄。
CDaoRecordset::Open	建立資料表、動態集 (Dynaset) 或快照的新資料錄集。
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 或編輯作業是在資料來源。

公用資料成員

名稱	描述
CDaoRecordset::m_bCheckCacheForDirtyFields	包含表示欄位是否有一個旗標會自動標記為已變更。
CDaoRecordset::m_nFields	在資料錄集類別包含欄位資料成員的數目和資料錄集選取的資料行數目從資料來源。
CDaoRecordset::m_nParams	在資料錄集類別—參數數目包含參數資料成員數目透過資料錄集的查詢
CDaoRecordset::m_pDAORecordset	對基礎資料錄集物件的 DAO 介面的指標。
CDaoRecordset::m_pDatabase	這個結果集的來源資料庫。含有指向 CDaoDatabase 物件。
CDaoRecordset::m_strFilter	包含用來 WHERE 字串來建構 SQL 陳述式。
CDaoRecordset::m_strSort	包含用來 ORDER BY 字串來建構 SQL 陳述式。

備註

稱為「資料錄集，」 CDaoRecordset 物件可用以下列三種形式:

資料表的資料錄集代表您可以使用單一資料庫資料表，檢查加入、變更，或刪除資料錄的基底資料表。
Dynaset 類型資料錄集是可更新的資料錄查詢的結果。這些資料錄集是可用來從基礎資料庫資料表或檢視，加入、變更，或刪除資料錄的資料錄集。 Dynaset 類型資料錄集可以在資料庫中包含一或多個資料表中的欄位。
快照集類型資料錄集是一組的靜態 (Static) 複本可用來尋找資料或產生報表記錄。這些資料錄集在資料庫包含一或多個資料表中的欄位，但無法更新。

在開啟檔案時，資料錄集每個表單都代表一個固定的一組資料錄的資料錄集。當您移動至資料表的資料錄集還是動態集類型的資料錄集的資料錄時，它會反映對的變更和資料錄，在開啟資料錄集，而其他使用者或已在應用程式的其他資料錄集。 (一個快照集類型資料錄集無法更新)。您可以直接使用 CDaoRecordset 或從 CDaoRecordset取得特定應用程式的資料錄集類別。您可以：

捲動記錄。
設定索引和快速尋找使用記錄中搜尋 (僅限資料表的資料錄集)。
尋找資料錄根據字串比較:「<」， <=」，「=」， >=」或「>」(動態集和快照集型別類型的資料錄集)。
更新資料錄並指定一個鎖定模式 (除了快照集類型資料錄集)。
篩選資料錄從這些選取資料來源中可使用的資料錄集限制。
排序資料錄集。
參數化資料錄集自訂其資訊的選項並不知道在執行階段之前。

將 CDaoRecordset 提供類別介面類似於類別 CRecordset。主要差異是類別 CDaoRecordset 存取資料的方式是將資料存取物件根據 OLE (DAO) 的。透過開放式資料庫連接 (Open Database Connectivity，ODBC) 會將 CRecordset 存取類別來實作和這個 DBMS 的 ODBC 驅動程式。

注意事項
DAO 資料庫類別會根據 Open 開放式資料庫連接的 MFC 資料庫類別本身不同 (ODBC)。所有 DAO 資料庫類別名稱中有「CDao」前置詞。您仍然可以存取使用 DAO 類別的 ODBC 資料來源，，因為它們是針對 Microsoft Jet 資料庫引擎， DAO 類別通常會提供絕佳的功能。

您可以直接使用 CDaoRecordset 或從 CDaoRecordset衍生類別。不論是使用資料錄集類別，開啟資料庫和建構資料錄集物件，透過建構函式指標至 CDaoDatabase 物件。您也可以 CDaoRecordset 建構物件並讓 MFC 建立暫存 CDaoDatabase 做為物件。然後呼叫資料錄集的成員函式開啟，指定物件是否為資料表的資料錄集、動態集類型的資料錄集或快照集類型資料錄集。呼叫開啟選取資料從資料庫和擷取第一筆資料錄。

使用物件的成員函式和資料成員至捲動資料錄並在它們。可用的作業是由物件是否屬於資料表的資料錄集、動態集類型的資料錄集或快照集類型資料錄集，，且是否可更新的或唯讀—這取決於資料庫或開放式資料庫連接 (Open Database Connectivity，ODBC) 資料來源的功能。重新整理可能已變更或加入的資料錄，因為開啟呼叫時，呼叫物件的重新查詢成員函式。當您完成使用後，請呼叫物件的成員函式關閉並終結該物件。

CDaoRecordset 使用 DAO 資料錄支援讀取和更新的欄位交換 (DFX) 記錄欄位會將您的 CDaoRecordset 或 CDaoRecordset衍生類別的型別安全 C++ 成員。使用 GetFieldValue 和 SetFieldValue，您也可以實作動態資料行繫結至資料庫中，而不需要使用 DFX 機制。

如需相關資訊，請參閱本主題中的<資料錄集物件」DAO 說明。