Método Resync

Atualiza os dados no objeto Recordset atual ou a coleção Fields de um objeto Record, no banco de dados subjacente.

Sintaxe

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

Parâmetros

AffectRecords
Opcional. Um valor AffectEnum que determina quantos registros o método Resync afetará. 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 foram substituídos. O valor padrão é adResyncAllValues.

Comentários

Conjunto de registros

Use o método Resync para sincronizar novamente os registros no Recordset atual com o banco de dados subjacente. Isso será útil se você estiver usando um cursor de somente avanço ou estático, mas quiser ver as alterações no banco de dados subjacente.

Se você definir a propriedade CursorLocation como adUseClient, o Resync só estará disponível para objetos Recordset que não são somente leitura.

Ao contrário do método Requery, o método Resync não executa novamente o comando subjacente do objeto Recordset. Novos registros no banco de dados subjacente não estarão visíveis.

Se a tentativa de uma nova sincronização falhar devido a um conflito com os dados subjacentes (por exemplo, um registro foi excluído por outro usuário), o provedor retornará avisos para a 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 estiverem definidas e o Recordset for o resultado da execução de uma operação JOIN em várias tabelas, o método Resync executará o comando dado 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 estiver definido como adResyncAllValues (o valor padrão), as propriedades UnderlyingValue, Value e OriginalValue dos objetos Field na coleção serão sincronizadas. Se ResyncValues estiver 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. Para objetos Field que têm valores Status de adFieldPendingUnknown ou adFieldPendingInsert, Resync não tem efeito. Para valores Status de adFieldPendingChange ou adFieldPendingDelete, Resync sincroniza valores de dados para campos que ainda existem na fonte de dados.

Resync não modificará os valores Status dos objetos Field, a menos que ocorra um erro quando Resync for chamado. Por exemplo, se o campo não existir mais, o provedor retornará um valor Status apropriado para o objeto Field, como adFieldDoesNotExist. Os valores Status retornados podem ser combinados logicamente dentro do valor da propriedade Status.

Aplica-se A

Coleção Fields (ADO)

Objeto Recordset (ADO)

Consulte Também

Exemplo do método Resync (VB)
Exemplo do método Resync (VC++)
Método Clear (ADO)
Propriedade UnderlyingValue