Обновляет ("освежает") Данные в соответствующих удаленных Представлениях SQL, а также в локальных Представлениях, и в курсорах, построенных на базе классов CursorAdapter.

REFRESH([nRecords [, nRecordOffset]] [, cTableAlias | nWorkArea])

Параметры

nRecords

Определяет количество Записей обновления. Если значение nRecords = 1 или параметр nRecords не указан, обновляется только текущая Запись. Если значение nRecords = 0, то обновление данных не выполняется.

nRecordOffset

Определяет количество Записей Представления, обновляемых вместе с текущей записью, и размещенных до текущей записи. Например, если текущая запись имеет номер = 10, а значение параметра nRecordOffset = 4, то записи обновляются начиная с записи с номером = 6. Если  значение nRecordOffset = 0 или параметр nRecordOffset не указан, то обновление начинается с текущей Записи Представления.

cTableAlias

Определяет имя Алиаса курсора, соответствующего рассматриваемому удаленному или локальному Представлению SQL, а также алиас Курсора, построенного на базе класса CursorAdapter, записи которого обновляются.

nWorkArea

Определяет номер Рабочей области, в которой открыт Курсор, записи которого обновляются. Если параметры nWorkArea или cTableAlias - отсутствуют, обновляются Записи курсора, открытого в текущей рабочей области.

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

Комментарии

Обновляемые Данные для записей Курсора выбираются из соответствующих Таблиц (источника данных), на основе которых построены соответствующие представления SQL или курсоры класса CursorAdapter. Если параметры в функции отсутствуют, то обновляются записи курсора Представления  или класса CursorAdapter, открытого в текущей рабочей области.

Примечание
REFRESH( ) не выполняет обновление содержания "Буфферизированных" записей; тем не менее, значения полей записей обновляются при использовании соответствующей функции CURVAL( ). Смотрите дополнительную информацию в разделе: CURVAL( ), функция.

Обратите Внимание
Обновляемые записи могут содержать уникальные первичные Ключи. Если, в этом случае, первичный ключ в Базовой Таблице не может быть найден (определен), то соответствующие записи Представления SQL или курсора класса CursorAdapter помечаются на-удаление.

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

См. также