virtual BOOL RepetirConsulta ( );
lançar ( CDBException, CMemoryException );
Valor de retorno
Diferente de zero se o conjunto de registros foi reconstruído com êxito; caso contrário 0.
Observações
Chame essa função de membro para recompilar (atualizar) um conjunto de registros. Se todos os registros são retornados, o primeiro registro se torna o registro atual.
Para que o conjunto de registros refletir as adições e exclusões que você ou outros usuários estão fazendo à fonte de dados, você deve reconstruir o conjunto de registros chamando RepetirConsulta. Se o conjunto de registros é um dynaset, ela reflete automaticamente atualizações que você ou outros usuários façam seus registros existentes (mas não adições). Se o conjunto de registros é um instantâneo, você deve chamar RepetirConsulta para refletir edições por outros usuários, bem como adições e exclusões.
Para um dynaset ou um instantâneo, chame RepetirConsulta qualquer hora que você deseja reconstruir o conjunto de registros usando um novo filtro ou classificar ou novos valores de parâmetro. Defina a propriedade de classificar ou filtro novo, atribuindo novos valores para m_strFilter e m_strSort antes de chamar RepetirConsulta. Definir novos parâmetros, atribuindo novos valores para os membros de dados de parâmetro antes de chamar RepetirConsulta. Se as seqüências de caracteres de filtro e classificação foram alteradas, você poderá reutilizar a consulta, o que melhora o desempenho.
Se a tentativa de reconstruir o conjunto de registros falhar, o conjunto de registros é fechado. Antes de chamar RepetirConsulta, você pode determinar se o conjunto de registros pode ser consulta à repetida, chamando a função de membro CanRestart . CanRestart não garante que RepetirConsulta terá êxito.
Cuidado Chamar RepetirConsulta somente depois que você tiver chamado Open.
Exemplo
Este exemplo recria um conjunto de registros para aplicar uma ordem de classificação diferente.
/ / Exemplo para CRecordset:: Requery
CCustSet rsCustSet (&NULL);
/ / Abrir o conjunto de registros
rsCustSet.Open ();
/ / Use o conjunto de registros...
/ / Definir a ordem de classificação e RepetirConsulta o conjunto de registros
rsCustSet.m_strSort = "District, Last_Name";
se (! rsCustSet.CanRestart ())
nbsp; retornar; / / Não é possível repetir a
se (! rsCustSet.Requery ())
/ / RepetirConsulta falhou, então agir
Visão geral de CRecordset | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;CRecordset::CanRestart, CRecordset::m_strFilter, CRecordset::m_strSort