CRecordset::EDIT

CRecordset::Edit

virtual void Edit();

throw( CDBException, CMemoryException );

说明：

此成员函数用来支持对当前记录的修改。当应用程序调用Edit之后，就可以通过直接重新设置字段数据成员的值来改变它们。当后来应用程序重新调用Update成员函数来将这些改变保存到数据源上时，这次操作才算完成。

注意：

如果你已经实现了成组行读取，你就不能调用Edit。这将导致一个失败断言。虽然类CRecordset不提供用于更新成组数据行的机制，但是你可以使用ODBC API函数SQLSetPos来编写你自己的函数。有关如何做到这一点的例子，请参见DBEFETCH示例。

Edit保存记录集的数据成员的值。如果你调用了Edit，进行了改变，然后再调用Edit，则记录的值被恢复到第一次调用Edit之前的值。

在某些情况下，你可能会想通过将一个列置为Null来更新它。要实现这一点，可以使用TRUE为参数调用SetFieldNull函数，来标记此字段为Null；这样也使此字段表列被更新。如果你想要将某一字段写入数据源，即使是它的值没有改变，则可以使用TRUE为参数调用SetFieldDirty函数。即使此字段的值为Null，这也同样可行。

如果数据源支持事务，则应用程序可以让Edit成为事务的一部分。值得注意的是，你应当在调用Edit之前，但在打开记录集之后，调用CDatabase::BeginTrans函数。还要注意，调用CDatabase::CommitTrans并不能代替调用Update来完成Edit操作。要获取有关事务的更多信息，请参见CDatabase类。

根据当前的加锁方式，正被更新的记录可能被Edit加锁，直到应用程序调用Update或滚动到另一个记录；也可能它只在Edit调用期间被加锁。你可以利用SetLocking Mode来改变加锁方式。

如果应用程序在调用Update之前滚动到了一个新的记录，则恢复当前记录的先前值。如果对一个不可修改的记录集调用Edit，或没有当前记录，则将抛出一个CDBException异常。

示例：

// CRecordset::Edit的示例：

// 编辑一个记录

// 首先设置编辑缓存

// rsCustSet.Edit();

// 然后编辑记录的字段数据成员

rsCustSet.m_dwCustID = 2795;

rsCustSet.m_strCustomer = "ones Mfg";

// 最后，完成此操作

if ( !rsCustSet.Update() )

// 处理更新失败