Обновляет текущие значения полей для указанных записей.

CursorAdapter.RecordRefresh([nRecords],[ nRecordOffset])

Параметры

nRecords

Указывает число записей, (следующих друг за другом в физическом порядке), подлежащих обновлению. nRecords представляет собой целое число большее или равное нулю. Если nRecords равно 1 или вы опускаете этот параметр, обновляются только значения полей в текущей записи. Если nRecords равно 0, обновления полей не производится.
nRecordOffset

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

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

Целое число. Метод RecordRefresh возвращает число обновленных записей или нуль, если записи не были обновлены, но и не было ошибок. Например, нуль возвращается в случае, если все целевые записи представляют собой буфферированные вставки или параметр nRecords равен нулю. В случае возникновения ошибки, при исполнении метода, возвращается отрицательное число, которое представляет число успешно обновленных записей, за вычетом единицы.

Примечания

Применяется к: классу CursorAdapter

Метож RecordRefresh обновляет текущие значения полей для целевых записей. Для определения текущих значений полей используйте функцию CURVAL( ).

Курсоры или таблицы должны быть открыты экслюзивно.

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

Если целевая запись не может быть найдена по крайней мере в одной из базовых таблиц, текущие значения полей игнорируются и не обновляются, а вся запись маркируется как удаленная (DELETED). Записи обновляются в порядке - запись за записью пока не будет обновлено число записей, определенное в параметре nRecords или не произойдет ошибка обновления. Ошибка генерируется в случае неуникальности обновляемого ключа.

Установка свойства FetchMemo объекта CursorAdapter учитывается во время операции обновления, если только для поля Memo установлен индекс. В этом случае, Memo-поле извлекается незаписмо от установки свойства FetchMemo. Затянувщееся исполнение метода RecordRefresh может быть прерывано нажатием ESC; в этом случае ошибка не генерируется.

Для определения причины сбоя метода RecordRefresh используйте функцию AERROR( ) . Команда ON ERROR и команда TRY...CATCH...FINALLY не могут быть использованы для определения причины ошибок, могущих произойти при исполнении метода RecordRefresh.

Метод RecordRefresh интегрирован с функцией REFRESH( ). Если функция REFRESH( ) вызывается для курсора, ассоциированного с объектом CursorAdapter, то будет вызван метод RecordRefresh объекта CursorAdapter. Для обратной совместимост, функция REFRESH( ) вернет нуль, если не удасться исполнить метод RecordRefresh.

Замечание:
Метод RecordRefresh использует свойства объекта CursorAdapter. В Visual FoxPro 8, функция REFRESH( ) всегда использует свойства курсора, установленные с помощью функции CURSORSETPROP( ) и считываемые с помощью функции CURSORGETPROP( ) независимо от того, будет курсор ассоциирован с объектом CursorAdapter или нет.

Смотри также

Справочное руководство

Функция CURVAL( )