Método Resync

Atualiza os dados no objeto recordset atual ou fields coleção de um objeto de registro, do 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 Campos de um objeto Record.

ResyncValues
Opcional. Um valor ResyncEnum que especifica se os valores subjacentes são substituídos. O valor padrão é adResyncAllValues.

Observações

Conjunto de registros

Use o método Resync para ressincronizar registros no do Conjunto de Registros atual com o banco de dados subjacente. Isso é útil se você estiver usando um cursor estático ou somente de encaminhamento, mas quiser ver as alterações no banco de dados subjacente.

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

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

Se a tentativa de ressincronizar 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 o Erros coleção 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 é o resultado da execução de uma operação JOIN em várias tabelas e, em seguida, o método Resync executará o comando dado na propriedade comando Resync somente na tabela nomeada na propriedade Unique Table.

Campos

Use o método Resync para ressincronizar os valores da coleção campos de de um objeto de registro 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, Valuee OriginalValue de objetos Field na coleção serão sincronizadas. Se ResyncValues estiver definido como adResyncUnderlyingValues, somente a propriedade de UnderlyingValue será sincronizada.

O valor da propriedade status para cada objeto de campo no momento da chamada também afeta o comportamento de Ressincronização. Para objetos Field que têm valores Status de adFieldPendingUnknown ou adFieldPendingInsert, Resync não tem nenhum efeito. Para valores de status de adFieldPendingChange ou adFieldPendingDelete, Resync sincroniza valores de dados para campos que ainda existem na fonte de dados.

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

Aplica-se a

da Coleção Fields (ADO)

do objeto Recordset (ADO)

Consulte Também

de exemplo do método ressincronização (VB)
exemplo de método ressincronização (VC++)
método Clear (ADO)
propriedade UnderlyingValue