Функция TABLEUPDATE( )

Фиксирует изменения, внесенные в буферизованную запись либо в буферизованную таблицу или курсор.

Синтаксис

TABLEUPDATE([lAllRows] [, lForce]] [, cTableAlias | nWorkArea])

Параметры

lAllRows

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

Если значение lAllRows "ложь" (.F.) и включена буферизация записей или таблиц, фиксируются только изменения текущей записи таблицы или курсора.

По умолчанию для lAllRows принимается значение "ложь" (.F.).

lForce

Определяет, следует ли вести запись поверх изменений, внесенных в таблицу или курсор другим пользователем сети. Если значение lForce "истина" (.T.), все изменения, внесенные в таблицу или курсор другим по ьзователем сети, перекрываются.

Если lForce есть "ложь" (.F.), Visual FoxPro фиксирует изменения в таблице или курсоре, ачиная с первой записи в направлении к концу таблицы или курсора. Если вст етится запись, модифицированная другим пользователем сети, Visual FoxPro генерирует ошибку.

Когда Visual FoxPro генерирует ошибку, для ее обработки может быть вызвана п ограмма ON ERROR, которая для фиксации изменений в записи может выдать функцию TABLEUPDATE( ) с аргументом lForce, равным значению "истина" (.T.). С другой стороны, если выполняется тра закция, программа ON ERROR может после обработки подобной ошибки выдать ROLLBACK, чтобы вернуть таблицу или курсор в исходное состояние.

По умолчанию для lForce принимается значение "ложь" (.F.).

cTableAlias

Задает псевдоним таблицы или курсора, в которых фиксируются изменения.

nWorkArea

Задает рабочую область таблицы или курсора, в которых фиксируются изменения.

Результат

Логический

Комментарии

Функция TABLEUPDATE( ) возвращает значение "истина" (.T.), если она выполнила фиксацию изменений во всех записях; в противном случае TABLEUPDATE( ) возв ащает "ложь" (.F.). Указатель записи остается на записи, изменения которой не уда ось зафиксировать. Чтобы определить причину, по которой не удалась фиксация, мож о воспользоваться функцией AERROR( ).

Функция TABLEUPDATE( ) не может фиксировать изменения, внесенные в таблицу или курсор, для которых не включена буферизация записей или таблиц. В подобном с учае Visual FoxPro сгенерирует сообщение об ошибке. Впрочем, TABLEUPDATE( ) может фиксировать изменения в таблице или курсоре, для которых предусмотрены прави а. Для включения или отключения буферизации записей и таблиц пользуйтесь фу кцией CURSORSETPROP( ).

Если функция TABLEUPDATE( ) выдана без аргументов cTableAlias или nWorkArea, изменения фиксируются для таблицы или курсора, открытых в выбранной в данный момент рабочей области.