Método Requery

Atualiza os dados em um recordset objeto executando novamente a consulta na qual o objeto se baseia.

Sintaxe

  
recordset.Requery Options  

Parâmetros

opções de
Opcional. Uma máscara de bits que contém ExecuteOptionEnum e valores de CommandTypeEnum que afetam essa operação.

Nota

Se Opções estiver definida como adAsyncExecute, essa operação será executada de forma assíncrona e um evento RecordsetChangeComplete será emitido quando for concluída. Os valores ExecuteOpenEnum de adExecuteNoRecords ou adExecuteStream não devem ser usados com Requery.

Observações

Use o método Requery para atualizar todo o conteúdo de um objeto Recordset da fonte de dados reutilizando o comando original e recuperando os dados uma segunda vez. Chamar esse método é equivalente a chamar os métodos Close e Open em sucessão. Se você estiver editando o registro atual ou adicionando um novo registro, ocorrerá um erro.

Embora o objeto Recordset esteja aberto, as propriedades que definem a natureza do cursor (CursorType, LockType, MaxRecordse assim por diante) são somente leitura. Assim, o método Requery só pode atualizar o cursor atual. Para alterar qualquer uma das propriedades do cursor e exibir os resultados, você deve usar o método Fechar para que as propriedades se tornem leitura/gravação novamente. Em seguida, você pode alterar as configurações de propriedade e chamar o método Open para reabrir o cursor.

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

exemplo de métodos Execute, Requery e Clear (VB)
exemplo de métodos Execute, Requery e Clear (VBScript)
exemplo de métodos Execute, Requery e Clear (VC++)
propriedade CommandText (ADO)