Возвращает последнее созданное значениедля автоинкрементного поля в соответствующей Сессии Данных.

GETAUTOINCVALUE([nDataSessionNumber | 0])

Параметры

nDataSessionNumber

Определяет номер сессии данных, для которой определяется последнее значение автоинкрементного поля.

При отсутствии параметра nDataSessionNumber или = 0, значение автоинкрементного поля возвращается для текущей сессии данных.

Для активации необходимой сессии данных используется команда SET DATASESSION.

0

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

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

Числового типа. Возвращаемое функцией GETAUTOINCVALUE( ) последнее значение для автоинкрементного поля создается вне зависимости произошло ли реальное изменение данного поля в источнике данных. Возвращается значение =.NULL., если для заданной сессии данных еще не создано соответствующее значение автоинкрементного поля. Например, если еще не производилось никаких изменений источника данных (добавления записей), то возвращается значение =.NULL.

Expand imageКомментарии

Изменение автоинкрементного поля происходит при таких операциях над таблицей, как APPEND, команда, INSERT, команда, APPEND FROM, команда, и BLANK, команда , при условии, что включена опция AUTOINC (в этих командах). См. дополнительно раздел Автоинкрементные поля в Таблицах .