Método Resync

Artículo
05/30/2023

Actualiza los datos del objeto Recordset actual o la colección Fields de un objeto Record de la base de datos subyacente.

Sintaxis

  
Recordset.Resync AffectRecords, ResyncValues Record.Fields.Resync ResyncValues

Parámetros

AffectRecords
Opcional. Un valor AffectEnum que determina cuántos registros afectará el método Resync. El valor predeterminado es adAffectAll. Este valor no está disponible con el método Resync de la colección Fields de un objeto Record.

ResyncValues
Opcional. Un valor ResyncEnum que especifica si se sobrescriben los valores subyacentes. El valor predeterminado es adResyncAllValues.

Comentarios

Recordset

Use el método Resync para resincronizar los registros del Recordset actual con la base de datos subyacente. Esto es útil si usa un cursor estático o de sólo avance, pero desea ver los cambios en la base de datos subyacente.

Si establece la propiedad CursorLocation en adUseClient, Resync solo está disponible para objetos Recordset que no son de solo lectura.

A diferencia del método Requery, el método Resync no vuelve a ejecutar el comando subyacente del objeto Recordset. Los nuevos registros de la base de datos subyacente no estarán visibles.

Si se produce un error en el intento de resincronizar debido a un conflicto con los datos subyacentes (por ejemplo, otro usuario ha eliminado un registro), el proveedor devuelve advertencias a la colección Errors y se produce un error en tiempo de ejecución. Utilice la propiedad Filter (adFilterConflictingRecords) y la propiedad Status para buscar registros con conflictos.

Si se establecen las propiedades dinámicas Unique Table y Resync Command y Recordset es el resultado de ejecutar una operación JOIN en varias tablas, el método Resync ejecutará el comando proporcionado en la propiedad Comando de resincronización solo en la tabla denominada en la propiedad Unique Table.

Campos

Utilice el método Resync para volver a sincronizar los valores de la colección Fields de un objeto Record con el origen de datos subyacente. La propiedad Count no se ve afectada por este método.

Si ResyncValues se establece en adResyncAllValues (valor predeterminado), se sincronizan las propiedades UnderlyingValue, Value y OriginalValue de los objetos Field de la colección. Si ResyncValues se establece en adResyncUnderlyingValues, solo se sincroniza la propiedad UnderlyingValue.

El valor de la propiedad Status para cada objeto Field en el momento de la llamada también afecta al comportamiento de Resync. Para los objetos Field que tienen valores Status de adFieldPendingUnknown o adFieldPendingInsert, Resync no tiene ningún efecto. Para los valores Status de adFieldPendingChange o adFieldPendingDelete, Resync sincroniza los valores de datos de los campos que todavía existen en el origen de datos.

La Resync no modificará los valores de Status de los objetos Field a menos que se produzca un error cuando se llame a Resync. Por ejemplo, si el campo ya no existe, el proveedor devolverá un valor Status adecuado para el objeto Field, como adFieldDoesNotExist. Los valores de Status devueltos se pueden combinar lógicamente dentro del valor de la propiedad Status.