Append

function Append: TAccessStatus -DESKTOP- -WEB-

Добавляет запись в форму.

Метод добавляет новую запись и переводит форму в режим вставки (State - dsInsert). Поля заполняются значениями по умолчанию (см. свойства полей «Значение по умолчанию», «Текущая дата», «Текущее время»).

При добавлении записи возникает цепочка событий: OnBeforeInsert, OnBeforeScroll, OnAfterInsert, OnAfterScroll.

Если до вызова метода форма находилась в режиме вставки/редактирования, то происходит автоматическое сохранение записи (вызывается метод Post). Обратите внимание, что проверка ввода при этом не выполняется. Чтобы выполнить проверку ввода, вызовите метод Validate.

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

Метод не добавит запись в подчиненную форму, если родительская форма не в режиме вставки/редактирования.

Метод игнорирует права доступа. Чтобы проверить права доступа, вызовите метод CanAppend.

Результат:

  • asOk - в случае успеха.
  • asCantAppend - если родительская форма не в режиме редактирования.