Справочник по компонентам Delphi. Часть 3 - Компонент TDatabase

ОГЛАВЛЕНИЕ

 

Компонент TDatabase

TObject -> TPersistent->TComponent -> TDatabase

Модуль DB

Страница Палитры компонентов DataAccess

Не используется при создают обычных приложений, работающих с базами данных, однако незаменим в приложениях клиент/сервер. В его функции входят:

  • установление постоянной связи с базой данных;
  • задание параметров сервера;
  • создание локальных псевдонимов BDE;
  • управление транзакциями. 

Свойства компонента

(Pb) property AliasName: TSymbolStr; TSymbolStr = String[DBIMAXNAMELEN] ; DBIMAXNAMELEN = 31;Имя псевдонима, заданного утилитой конфигурации BDE. Значение этого свойства обнуляется при установке свойства DriverName. Используется для связывания с определенным сервером.
(pb) property Connected: Boolean;Управляет процессом соединения компонента с базой данных. В состоянии True разрешает соединение и открытие таблиц. Работает совместно со свойством Keep Connection.
(Pb) property DatabaseName: TFileName; TFileName: String[79];Задает псевдоним присоединяемой базы данных для приложения, который может использоваться компонентами наборов данных (TTable, TQuery) и отображается в их свойстве DatabaseName.
(Ro) property DatasetCount: Integer;Отражает число компонентов наборов данных, используемых невизуальным компонентом TDatabase.
(Ro) property Datasets[Index: Integer]: TDBDataset;Массив указателей на экземпляры компонентов присоединенных наборов данных.
(Pb) property DriverName: TSymbolStr;Имя используемого приложением драйвера BDE. Это свойство обнуляется при определении свойства AliasName.
(ro)property Handle: HDBIDB; Указатель на базу данных, используется для прямого вызова функции API BDE.
(Ro) property IsSQLBased: Boolean;Отражает тип используемого драйвера, зависит от свойства DriverName. Состояние True разрешает использование любого драйвера, кроме STANDARD.
(Pb) property KeepConnection: Boolean;В значении True задает постоянное соединение с базой данных даже при отсутствии открытых наборов данных. При выключенном свойстве для регистрации на сервере необходимо пользоваться свойством Connected для каждого открытия таблицы.
(Ro) property Locale: TLocale;Определяет используемый компонентом языковый драйвер. Позволяет осуществлять прямой доступ к API BDE.
(Pb) property LoginPrompt: Boolean;В стандартном значении True определяет, что при установке соединения с базой данных будет появляться диалоговое окно регистрации пользователя. В значении False регистрационные сведения должны содержаться в полях свойства Params.
(Pb) property Params: TStrings;Содержит параметры, необходимые для подключения к базам данных. По умолчанию это значение свойства устанавливается в соответствие с информацией утилиты конфигурации BDE.
property Temporary: Boolean;Определяет способ создания компонента. True означает, что компонент создается только при открытии таблицы и будет уничтожен при ее закрытии. Если затем свойство установить в False, то компонент будет сохранен. Если при создании компонента свойство было установлено в False, то переопределение в True будет означать уничтожение компонента после закрытия последней таблицы.
(Pb) property Translsolation: TTransIeolation;Определяет уровень изоляции транзакции и используется SQL-сервером. Значение tiDirtyRead разрешает транзакции читать незавершенные изменения, проведенные другой транзакцией; tiReadCommit открывает доступ к изменениям после завершения транзакции; tiRepeatableRead полностью изолирует транзакцию.

Методы компонента

procedure Close; Отсоединяет все связанные с ним компоненты TTable TQuery и TStoredProc.
procedure CloseDatasets; Отсоединяет все дочерние компоненты класса TDataSet, но сам компонент остается открытым.
procedure Commit; Фиксирует все изменения, проведенные транзакцией. Этот метод можно исполь­зовать только при наличии связи с базой данных.
procedure Open; Соединяет компонент с сервером или BDE в случае использования СУБД Paradox или dBase.
procedure Rollback; Отменяет все действия, совершенные транзакцией, то есть запрещает ее фиксацию.
procedure StartTransaction; Начинает выполнение транзакции, используя уровень изоляции из свойства Translsolation. Этот метод рекомендуется использовать только при наличии связи с базой данных.