CRecordset::repetir consulta

Artigo
08/25/2010

Recria (atualizações) um conjunto de registros.

virtual BOOL Requery( );

Valor de retorno

Diferente de zero se o conjunto de registros foi reconstruído com êxito; caso contrário, 0.

Comentários

Se todos os registros são retornados, o primeiro registro se tornará o registro corrente.

A fim de conjunto de registros refletir as adições e exclusões que você ou outros usuários estão fazendo a fonte de dados, você deve recompilar o conjunto de registros chamando repetir consulta.Se o conjunto de registros for um dynaset, ele refletirá 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ê deverá telefonar Repetir a consulta para refletir edições por outros usuários, além de adições e exclusões.

Para um dynaset ou snapshot, telefonar Repetir a consulta qualquer vez que você reconstrua o conjunto de registros usando um novo filtro ou classificar ou novos valores de parâmetro.conjunto a propriedade de classificar ou novo filtro ao atribuir novos valores para m_strFilter and m_strSort antes de ligar repetir consulta.conjunto novos parâmetros ao atribuir novos valores para os membros de dados de parâmetro antes de chamar repetir consulta.Se as seqüências de caracteres de filtro e classificar inalteradas, você pode reutilizar a consulta, o que melhora o desempenho.

Se a tentativa de recompilar o conjunto de registros falhar, o conjunto de registros será fechado.Antes de chamar Repetir a consulta, você pode determinar se o conjunto de registros pode ser novamente consultado, chamando o CanRestart função de membro. CanRestart não é garantia de que repetir consulta será bem-sucedida.

Cuidado:
Call repetir consulta somente depois que você tenha chamado em aberto.

Exceções

Esse método pode lançar exceções do tipo CDBException * and CMemoryException*.

Exemplo

Este exemplo recria um conjunto de registros para aplicar uma ordem de classificar diferente.

CCustomer rsCustSet(&m_dbCust);

// Open the recordset
rsCustSet.Open();

// Use the recordset ...

// Set the sort order and Requery the recordset
rsCustSet.m_strSort = _T("L_Name, ContactFirstName");
if(!rsCustSet.CanRestart())
   return;    // Unable to requery

if(!rsCustSet.Requery())
   // Requery failed, so take action
   AfxMessageBox(_T("Requery failed!"));