CRecordset::Requery

Виртуальный BOOL Повторный запрос ( );
бросить ( CDBException, CMemoryException );

Возвращаемое значение

Ненулевое значение если набор записей был успешно восстановлен; в противном случае 0.

Примечания

Вызов этой функции-члена для восстановления (обновить) набора записей. Если возвращаются все записи, первая запись становится текущей записи.

Для того чтобы набор записей отразить добавления и удаления, который вы или другие пользователи вносят в источнике данных необходимо перестроить набора записей путем вызова функции Requery. Если набор записей динамическим множеством, он автоматически отражает обновления, которые вы или другие пользователи делают его существующих записей (но не дополнения). Если набор записей является моментальным снимком, необходимо вызвать Requery для отражения изменения другими пользователями, а также дополнения и удалений.

Для динамического подмножества или моментального снимка вызовите Requery любое время вы хотите восстановить набор записей с помощью фильтра или сортировки или новые значения параметров. Установите новый фильтр или свойства sort путем присвоения новых значений m_strFilter и m_strSort перед вызовом функции Requery. Задайте новые параметры, назначив новые значения членов данных параметров перед вызовом функции Requery. Если фильтр и сортировка строк являются неизменными, можно повторно использовать запрос, который улучшает производительность.

Если не удается восстановить набор записей, набор записей будет закрыта. Перед вызовом метода Requery, определить, можно ли набор записей можно опросить путем вызова функции-члена CanRestart . CanRestart не гарантирует, что повторный запрос преуспеет.

Осторожно   Вызовите Requery только после того, как вы вызвали открытый.

Пример

В этом примере перестраивается записей применять другой порядок сортировки.

/ / Пример для CRecordset::Requery

CCustSet rsCustSet (&NULL);

/ / Открыть набор записей
rsCustSet.Open ();

/ / Использовать набор записей...

/ / Установить порядок сортировки и Requery набора записей
rsCustSet.m_strSort = «Округ, фамилия»;
Если (! rsCustSet.CanRestart ())
 nbsp; возвращение;    / / Не в состоянии повторный запрос

Если (! rsCustSet.Requery ())
   / / Не requery, так что принять меры

Обзор CRecordsetЧлены класса | Иерархическая схема

См. также CRecordset::CanRestart, CRecordset::m_strFilter, CRecordset::m_strSort

Index