Método ressíncrono (ADO)
Aplica-se ao: Access 2013, Office 2013
Atualiza os dados no objeto Recordset atual, ou a coleção Fields de um objeto Record, a partir do banco de dados subjacente.
Sintaxe
Conjunto de registros. RessyncAffectRecords, ResyncValues
Gravar. Campos. ResyncResyncValues
Parâmetros
| Parâmetro | Descrição |
|---|---|
| AffectRecords | Opcional. Um valor AffectEnum que determina a quantidade de registros que serão afetados pelo método Resync. O valor padrão é adAffectAll. Esse valor não está disponível com o método Resync da coleção Fields de um objeto Record. |
| ResyncValues | Opcional. Um valor ResyncEnum que especifica se os valores subjacentes serão substituídos. O valor padrão é adResyncAllValues. |
Comentários
Conjunto de Registros
Use o método Resync para sincronizar novamente os registros do Recordset atual com o banco de dados subjacente. Esse procedimento será útil se você estiver usando um cursor estático ou somente de encaminhamento e desejar ver as alterações no banco de dados subjacente.
Se você definir a propriedade CursorLocation como adUseClient, Resync somente estará disponível para os objetos Recordset que não sejam somente leitura.
Diferente do método Requery, o método Resync não reexecuta o comando subjacente do objeto Recordset. Os novos registros no banco de dados subjacente não estarão visíveis.
Se a tentativa de nova sincronização falhar devido a um conflito com os dados subjacentes (por exemplo, por causa da exclusão de um registro por outro usuário), o provedor retornará avisos à coleção Errors e ocorrerá um erro em tempo de execução. Use a propriedade Filter (adFilterConflictingRecords) e a propriedade Status para localizar registros com conflitos.
Se as propriedades dinâmicas Unique Table e Resync Command forem definidas e Recordset resultar da execução de uma operação JOIN em várias tabelas, o método Resync executará o comando fornecido na propriedade Resync Command somente na tabela nomeada na propriedade Unique Table.
Campos
Use o método Resync para sincronizar novamente os valores da coleção Fields de um objeto Record com a fonte de dados subjacente. A propriedade Count não é afetada por esse método.
Se ResyncValues for definido como adResyncAllValues (o valor padrão), ocorrerá sincronização das propriedades UnderlyingValue, Value e OriginalValue dos objetos Field da coleção. Se ResyncValues for definido como adResyncUnderlyingValues, somente a propriedade UnderlyingValue será sincronizada.
O valor da propriedade Status para cada objeto Field no momento da chamada também afeta o comportamento de Resync. Resync não terá efeito para os objetos Field com valor adFieldPendingUnknown ou adFieldPendingInsert para Status. Para o valor adFieldPendingChange ou adFieldPendingDelete de Status, Resync sincronizará os valores de dados dos campos ainda existentes na fonte de dados.
Resync will not modify Status values of Field objects unless an error occurs when Resync is called. For example, if the field no longer exists, the provider will return an appropriate Status value for the Field object, such as adFieldDoesNotExist. Returned Status values may be logically combined within the value of the Status property.