virtual BOOL Update ( );
tirar ( CDBException );
Valor devuelto
Distinto de cero si se actualizó correctamente un registro; caso contrario 0 si no hay columnas han cambiado. Si no hay registros fueron actualizados, o si hay más de un registro se actualizó, se produce una excepción. También se produce una excepción de cualquier otra falla en el origen de datos.
Observaciones
Llame a esta función miembro después de una llamada a la función miembro AddNew o Editar . Esta convocatoria es necesario para completar la operación AddNew o Editar.
&Notanbsp; Si han implementado la obtención masiva de filas, no se puede llamar a Update. Esto resultará en una aserción fallida. Aunque la clase CRecordset no proporcionan un mecanismo de actualización masiva de filas de datos, puede escribir sus propias funciones mediante la función de la API de ODBC SQLSetPos. Un ejemplo de cómo hacerlo, vea el ejemplo DBFETCH. Para obtener más información sobre la obtención masiva de filas, vea el artículo conjunto de registros: obtener registros en masiva (ODBC) en la Guía del programador de Visual C++.
AddNew y Editar preparan un búfer de edición en la cual se colocan los datos agregados o modificados para salvar al origen de datos. Actualización guarda los datos. Se actualizan sólo aquellos campos marcados o detectado como cambiado.
Si el origen de datos admite transacciones, puede hacer la llamada a Update (y su correspondiente AddNew o Editar llamar) forma parte de una transacción. Para obtener más información acerca de las transacciones, consulte el artículo Transacción (ODBC) en la Guía del programador de Visual C++.
Precauciónnbsp; Si llamar a Update sin llamar primero bien Add&New o Editar, Actualizar arroja un CDBException. Si llama a AddNew o Editar, debe llamar a Update antes de llamar a una operación de Mover o antes de cerrar bien el juego de registros o la conexión de origen de datos. De lo contrario, los cambios se pierden sin notificación.
Para detalles sobre el manejo de errores de actualización , consulte el artículo conjunto de registros: cómo se actualizan los registros (ODBC) en la Guía del programador de Visual C++.
Ejemplo
Consulte el artículo transacción: realizar una transacción en un conjunto de registros (ODBC) en la Guía del programador de Visual C++.
Visió&n General de CRecordset |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambiénnbsp;CRecordset::Edit, CRecordset::Add&New, CRecordset::SetFieldDirty, CDBException