CRecordset::Update
藉由將新的或編輯之資料進行 AddNew 或 編輯 作業是在資料來源。
virtual BOOL Update( );
傳回值
不是零,則會在成功更新資料錄,則為 0,如果資料行並未變更。 如果資料錄未更新,則為,如果一個以上的資料錄更新,便會擲回例外狀況。 例外狀況為資料來源中的任何其他失敗也會擲回。
備註
呼叫此成員函式,在呼叫 AddNew 或 編輯 成員函式之後。 這個呼叫完成 AddNew 或 編輯 作業。
注意事項 |
---|
如果您已實作大量資料列擷取,就無法呼叫 更新。這樣會造成失敗的判斷提示。雖然類別 CRecordset 為更新大量資料列不提供一種機制,使用 ODBC API 函式 SQLSetPos,您可以撰寫自己的函式。如需大量資料列擷取的詳細資訊,請參閱本文 資料錄集:擷取大量資料錄 (ODBC)。 |
AddNew 和 編輯 準備加入或編輯資料儲存在此資料來源的編輯緩衝區。 更新 保留資料。 做為變更標記或偵測的那些欄位更新。
如果資料來源支援交易,您可以 更新 呼叫 (及其對應 AddNew 或 編輯 呼叫) 部分交易。 如需交易的詳細資訊,請參閱本文 交易 (ODBC)。
警告
如果您呼叫 更新 ,而不要先呼叫 AddNew 或 編輯, 更新 擲回 CDBException。如果您呼叫 AddNew 或 編輯,您必須呼叫 更新 ,才能呼叫 移動 作業之前,或在您關閉資料錄集或資料來源連接之前。否則,您的變更將會遺失,且不會發出通知。
如需處理 更新 失敗的詳細資訊,請參閱本文 資料錄集:如何將資料錄集更新資料錄 (ODBC)。
例外狀況
這個方法會擲回型別 **CDBException***的例外狀況。
範例
請參閱文件 交易:執行交易在資料錄集 (ODBC)。
需求
Header: afxdb.h