Справочник по компонентам Delphi. Часть 3 - Компонент TDatabase
ОГЛАВЛЕНИЕ
Страница 21 из 44
Компонент 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. Этот метод рекомендуется использовать только при наличии связи с базой данных. |