Руководство разработчика

Объектный тип БАЗА_ДАННЫХ

Физический объектный тип c передачей ответственности "справа налево".

Объект БАЗА_ДАННЫХ предназначен для локальной однопользовательской работы с таблицами данных. В настоящий момент поддерживаются форматы DBASE (DBF), Paradox (DB) и обощенный режим работы через ODBC. Учитывая, что многие программы имеют возможность сохранять и загружать данные в форматах DBF и DB, объект БАЗА_ДАННЫХ полезен для осуществления импорта/экспорта. Также объект может использоваться для осуществления запросов к расположенной на клиентском месте специализированной базе данных, для чего имеется возможность исполнять SQL-запросы. Объект БАЗА_ДАННЫХ является физическим, т.е. при копировании (присваивании) передает свое физическое представление. При разрушении объекта открытые таблицы автоматически закрываются.

Поля

Тип Поле Описание Значение по умолчанию
СТРОКА типТип драйвера базы данных. Поле может принимать следующие значения:
  • "DBASE" – база данных в формате DBF;
  • "PARADOX" – база данных в формате DB;
  • "BDE_DBASE" – база данных в формате DBF, использовать BDE напрямую;
  • "BDE_PARADOX" – база данных в формате DB, использовать BDE напрямую;
  • "ODBC" – подключение к произвольной базе данных с использованием интерфейса ODBC. Этот режим позволяет работать с базами данных, не основанными на файлах и папках (как в случае DBASE и PARADOX). Для этого режима в поле дир указывается строка соединения ODBC, параметры которой зависят от типа базы данных.
Если значение не указано (или указано значение, отличное от приведенных) – по умолчанию используется формат DBF.
СТРОКА дирПапка базы данных. Путь к папке задается относительно папки DBF, заданной в глобальных настройках платформы. Для использования произвольной папки вне папки DBF необходимо задать абсолютный путь. Для режима ODBC задает строку соединения.
СТРОКА опцииДополнительные параметры открытия базы данных и таблицы. Поле может принимать значения из набора констант БД_ОПТ_... По умолчанию таблица открывается в режиме двунаправленной прокрутки и видимости изменений (dynaset). Режимы dynaset, snapshort и forward only являются взаимоисключающими. Режим открытия таблицы игнорируется при использовании BDE напрямую. Опции открытия базы данных могут использоваться совместно. Для этого достаточно сложить значения соответствующих констант. Например: БД_ОПТ_ТОЛЬКО_ЧТЕНИЕ + БД_ОПТ_СНИМОК.

Методы

МетодОписание
ОТКРЫТЬ Открывает таблицу.
СОЗДАТЬ_ТАБЛИЦУ Позволяет определить поля новой таблицы без непосредственного задания SQL-запроса.
ЗАПРОС Выполняет SQL-запрос к таблице или базе данных.
ЗАКРЫТЬ Закрывает ранее открытую таблицу, связанную с объектом.
ОТКРЫТА Проверяет, связан ли объект с открытой таблицей.
ПОСЛ_ОШИБКА Возвращает текст сообщения о последней ошибке.
ИМЯ Возвращает имя открытой таблицы.
ДИР Позволяет получить полный путь к папке файловой базы данных при работе с таблицами DBASE или PARADOX.
ПЕРВАЯ Осуществляет переход на первую запись в таблице.
ПОСЛЕДНЯЯ Осуществляет переход на последнюю запись в таблице.
СЛЕД Осуществляет переход к следующей записи.
ПРЕД Осуществляет переход к предыдущей записи.
УСТ_ПОЗ Осуществляет переход к записи с указанным номером.
НАЧ Возвращает признак начала таблицы.
КОН Возвращает признак конца таблицы.
РАЗМЕР Подсчитывает количество записей в таблице.
ДОБАВИТЬ Добавляет запись в таблицу и делает ее текущей.
УДАЛИТЬ Удаляет текущую запись.
КОЛ_ПОЛЕЙ Возвращает количество полей в базе данных.
ИМЯ_ПОЛЯ Возвращает имя поля по номеру.
ТИП_ПОЛЯ Возвращает тип поля по имени.
ПОЛЕ Возвращает значение поля с заданным именем для текущей записи.
ЗАП_ПОЛЕ Устанавливает значение заданного поля в текущей записи.
ПОЛЕ_NULL Позволяет проверить наличие значения заданного поля в текущей записи.
ЗАП_ПОЛЕ_NULL Позволяет установить признак отсутствия значения заданного поля в текущей записи.

См. также: