Compartir a través de


CRecordset::Update

Completa una operación de AddNew o de Editar guardar nuevos o editar datos en el origen de datos.

virtual BOOL Update( );

Valor devuelto

Distinto de cero si un registro se actualizó correctamente; si no 0 si ninguna columna han cambiado.Si no se actualizó ningún registro, o si más de un registro se ha actualizado, se produce una excepción.También se produce una excepción para cualquier otro error en el origen de datos.

Comentarios

Llame a esta función miembro después de una llamada funciones miembro de AddNew o de Editar .Esta llamada se necesita para completar AddNew o la operación de Editar .

[!NOTA]

Si está implementada la obtención de filas masiva, no puede llamar a Actualizar.Esto da lugar a un error de aserción.Aunque la clase CRecordset no proporcionan un mecanismo para actualizar filas masivas de datos, puede escribir las propias funciones mediante la función API SQLSetPosde ODBC.Para obtener más información sobre la obtención masiva de filas, vea el artículo conjunto de registros: Obtener registros de forma masiva (ODBC).

AddNew y Editar preparan un búfer de edición en el que los datos agregados o editando se coloque para guardar el origen de datos.Update guarda los datos.Solo los campos marcados o detectados como cambiado se actualizan.

Si el origen de datos admite transacciones, puede crear la parte de la llamada de Update (y el AddNew o llamada correspondiente de Editar ) de una transacción.Para obtener más información sobre transacciones, vea el artículo transacción (ODBC).

Nota de precauciónPrecaución

Si llama a Update sin la primera llamada AddNew o Editar, Update produce CDBException.Si llama a AddNew o Editar, debe llamar a Actualizar antes de llamar a una operación de Mover o antes de cerrar el conjunto de registros o la conexión a un origen de datos.Si no, los cambios se pierden sin notificación.

Para obtener información sobre cómo administrar los errores de Actualizar , vea el artículo conjunto de registros: Actualizar los registros (ODBC).

Excepciones

Este método puede producir excepciones de **CDBException***escrito.

Ejemplo

Vea el artículo transacción: Realizar una transacción en un conjunto de registros (ODBC).

Requisitos

encabezado: afxdb.h

Vea también

Referencia

Clase CRecordset

Gráfico de jerarquía

CRecordset::Edit

CRecordset::AddNew

CRecordset::SetFieldDirty

Clase CDBException