Compartilhar via


Método Requery

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

Sintaxe

  
recordset.Requery Options  

Parâmetros

Opções
Opcional. Uma bitmask que contém os valores ExecuteOptionEnum e CommandTypeEnum que afetam essa 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. Os valores ExecuteOpenEnum de adExecuteNoRecords ou adExecuteStream não devem ser usados com Requery.

Comentários

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.

Enquanto o objeto Recordset está aberto, as propriedades que definem a natureza de cursor (CursorType, LockType, MaxRecords e assim por diante) são somente leitura. Portanto, o método Requery só pode atualizar o cursor atual. Para alterar alguma das propriedades do cursor e exibir os resultados, você precisa usar o método Close 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

Objeto Recordset (ADO)

Consulte Também

Exemplo dos métodos Execute, Requery e Clear (VB)
Exemplo dos métodos Execute, Requery e Clear (VBScript)
Exemplo dos métodos Execute, Requery e Clear (VC++)
Propriedade CommandText (ADO)