Método Requery (ADO)
Aplica-se ao: Access 2013, Office 2013
Atualiza os dados em um objeto Recordset, reexecutando a consulta que serve de base ao objeto.
Sintaxe
conjunto de registros. Opções requery
Parâmetros
| Nome | Descrição |
|---|---|
| Opções | Opcional. Um bitmask contendo os valores ExecuteOptionEnum e CommandTypeEnum que afetam esta operação. |
Observação
Se Options estiver definido como adAsyncExecute, essa operação será executada de forma assíncrona e um evento RecordsetChangeComplete será emitido quando for concluído.
O valor adExecuteNoRecords ou adExecuteStream de ExecuteOpenEnum não deve ser usado com Requery.
Comentários
Use o método Requery para atualizar todo o conteúdo de um objeto Recordset a partir da fonte de dados, emitindo novamente o comando original e recuperando os dados uma segunda vez. A chamada desse método equivale à chamada dos métodos Close e Open sucessivamente. Se você estiver editando o registro atual ou adicionando um novo registro, ocorrerá erro.
Enquanto o objeto Recordset estiver aberto, as propriedades que definem a natureza do cursor (CursorType, LockType, MaxRecords etc.) serão somente leitura. Portanto, o método Requery somente poderá atualizar o cursor atual. Para alterar qualquer propriedade do cursor e exibir os resultados, use o método Close para tornar as propriedades novamente como leitura/gravação. Em seguida, você poderá alterar as configurações de propriedade e chamar o método Open para reabrir o cursor.