AllowStreamedConnected: boolean | Когда свойство выствлено в TRUE (по умолчанию), то установка в design-time свойства Connected в TRUE (т.е., подключение к базе) заставит компонент автоматически соединиться с базой и при запуске программы. Если же свойство выставлено в FALSE, то даже при включенном Connected при запуске придётся принудительно открывать базу данных либо повторной установкой Connected, либо вызовом метода Open. Сделано это для тех случаев, когда в design-time используется другая (например, локальная) база данных, чем в runtime. |
Connected: boolean | Определяет, активно ли соединение. Установка свойства приводит к открытию (Connected := TRUE) или закрытию (Connected := FALSE) соединения. Важно помнить, что открытие соединения не приводит к автоматическому открытию связанных с ним наборов данных. |
DatabaseName: string | Определяет физическое имя базы данных, ассоциированной с компонентом. Синтаксис отличается для различных видов подключения. Локальный файл: <filename> TCP/IP: <server_name>:<filename> NetBEUI: \\<server_name>\<filename> SPX: <server_name>@<filename> |
DBParamByDPB: [const Idx: Integer]: string | используется для работы с параметрами напрямую, минуя свойство Params. Есс-но, для это придётся знать внутренние константы IB. например, DBParamByDPB[isc_dpb_user_name] может использоваться для установки и чтения имени пользователя. Остальные константы можно посмотреть в IbHeader.pas, сделав поиск по "Database parameter block stuff" |
DBSQLDialect: Integer; | Возвращает используемый базой данных диалект. Только для чтения. |
DefaultTransaction: TIBTransaction | Транзакция, используемая по умолчанию. Если ваше приложение использует всего одну транзакцию, то именно сюда её и следует прописать. |
Handle: TISC_DB_Handle | Дескриптор базы данных, используемый для прямых вызовов API Interbase. Устанавливается при открытии базы данных. Только для чтения. |
HandleIsShared: Boolean | Внутренний флаг, указывающий, используется ли ещё где либо дескриптор базы данных. Только для чтения. |
IdleTimer: Integer | Интервал времени в миллисекундах, по истечении которого компонент автоматически разорвёт "простаивающее" соединение. По умолчанию равен 0, т.е. - выключен. |
InternalTransaction: TIBTransaction | Для внутреннего использования. Только для чтения. |
IsReadOnly: Boolean | Является ли база read-only. Работает только для IB 6.0 и выше (в т.ч. - Firebird). Только для чтения. |
Params: TStrings | Список параметров, которые в момент подключения будут переданы серверу СУБД. Имеют структуру <name>=<value>. Например:
user_name=sysdba
password=masterkey
sql_role_name=finance
lc_ctype=WIN1251 |
SQLDialect: Integer | Используется для установки диалекта, с которым вы собираетесь подключиться к базе данных. При уже открытой базе значение не может быть выставлено выше реального диалекта БД. Если же при подключении окажется, что заданный диалект превышает реальный, будет сгенерированно событие OnDialectDowngradeWarning, и диалект будет понижен автоматически. На данный момент, собственно, диалектов всего два: 1 и 3, поэтому имеет смысл всегда выставлять 3, это гарантирует, что ваша прога сможет подключиться. |
SQLObjectCount: Integer | Число sql-объектов в базе данных. Таковыми считаются таблицы, запросы и blob'ы. |
SQLObjects[Index: Integer]: TIBBase | Даёт доступ ко всем sql-объектам в базе данных. |
TraceFlags: TTraceFlags | Используется для установки набора операций, выполнение которых впоследствии можно будет оттрассировать компонентом TIbSqlMonitor. |
TransactionCount: Integer | Кол-во транзакций, ассоциированных с компонентом. |
Transactions [Index: Integer]: TIBTransaction | Список всех транзакций по индексу. |
DataSetCount: Integer | Количество всех наборов данных, перечисленных в свойстве DataSets. |
DataSets[Index: Integer]: TDataSet | Список всех открытых наборов данных. |
LoginPrompt: Boolean; | Определяет, будет ли при подключении выдаваться стандартный диалог на ввод имени(логина) и пароля. Если выставлен в FALSE, то вам самим придётся позаботиться о передаче серверу этих данных, например, с помощью свойства Params. |
procedure AddEventNotifier(Notifier: IIBEventNotifier); | Позволяет регистрировать на сервере события, при возникновении которых приложение будет получать уведомление от сервера. Используется внутренне для взаимодействия с компонентами типа TIbEvents. |
function AddTransaction(TR: TIBTransaction): Integer | Добавляет транзакцию в список транзакций (Transactions), возвращая её индекс. |
procedure ApplyUpdates(const DataSets: array of TDataSet) | Отправляет кэшированные изменения на сервер для указанного списка наборов данных. |
function Call (ErrCode: ISC_STATUS; RaiseError: Boolean): ISC_STATUS | Возвращает ошибку и, при желании, возбуждает исключительную ситуацию. |
procedure CheckActive | Возбуждает ИС, если база данных не открыта. |
procedure CheckDatabaseName | Возбуждает ИС, если свойство DatabaseName не установлено. |
procedure CheckInactive | Возбуждает ИС, если база данных открыта. |
procedure CloseDataSets | Закрывает все активные наборы данных, не обрывая соединение с базой данных. |
constructor Create(AOwner: TComponent) | Конструктор компонента. После создания, списки наборов данных (DaytaSets) и параметров (Params) будут пустыми. |
procedure CreateDatabase | Создаёт базу данных с указанным именем (DatabaseName), диалектом (SqlDialect) и заданными параметрами (Params). |
destructor Destroy | Деструктор компонента. При необходимости освободить динамически созданный объект, рекомендуется использовать Free. |
procedure DropDatabase | Физически удаляет текущую (открытую) базу данных. Если база данных не открыта - свалится в exception. |
function FindDefaultTransaction(): TIBTransaction | Возвращает транзакцию, заданную по умолчанию (DefaultTransaction). |
function FindTransaction (TR: TIBTransaction):Integer; | Возвращает индекс указанной транзакции в списке транзакций (Transactions). |
procedure FlushSchema | Очищает программный кэш компонента. |
procedure ForceClose | Принудительное закрытие базы. Даже если попытка корректно закрыть соединение обломилась, дескриптор базы данных (Handle) всё равно будет выставлен в nil. |
procedure GetFieldNames(const TableName: string; List: TStrings) | Возвращает список всех полей в указанной таблице текущей базы данных. Список уже должен существовать. |
procedure GetTableNames(List: TStrings; SystemTables: Boolean =False) | Возвращает список всех таблиц. SystemTables определяет, будут ли включены в список системные таблицы. Список уже должен существовать. |
function Has_COMPUTED_BLR(Relation, Field : String) : Boolean | Определяет, содержит ли поле в указанной реляции (таблице или просмотре) аттрибут COMPUTED_BLR. |
function Has_DEFAULT_VALUE(Relation, Field : String) : Boolean | Определяет, содержит задано ли для поля в указанной реляции (таблице или просмотре) значение по умолчанию. |
function IndexOfDBConst(st: String): Integer | Возвращает индекс параметра st из списка параметров базы данных. См. также DbParamByDPB. |
procedure RemoveEventNotifier(Notifier: IIBEventNotifier) | Удаляет обработчик события, после чего компонент перестаёт автоматически регистровать это событие при открытии/закрытии базы данных. |
procedure RemoveTransaction(Idx: Integer) | Удаляет указанную транзакцию из списка транзакций (Transactions). |
procedure RemoveTransactions | Очищает список транзакций. |
procedure SetHandle(Value: TISC_DB_HANDLE) | Устанавливает дескриптор (Handle) для базы данных. |
function TestConnected: Boolean | Проверяет, установленно ли соединение с базой данных. В отличие от свойства Connectedданная функция вернёт TRUE только тогда, когда соединение действительно существует (после обрыва сети, например, Connected всё равно можно остаться в TRUE, а вот TestConnected всегда "скажет правду"). |
procedure Close | Разрывает соединение с базой данных, предварительно отключая все наборы данных и транзакции. То же самое, что установка Connected в FALSE. |
procedure Open | Устанавливает соединение с базой данных. То же самое, что установка Connectedв TRUE. |
OnDialectDowngradeWarning: TNotifyEvent | Возникает при понижении диалекта, указаного в компоненте. Например, если диалект в программе равен 3, а диалект базы, к которой мы пытаемся подключиться равен 1, то он будет автоматически понижен и возникнет данное событие. См. также SQLDialect. |
OnIdleTimer: TNotifyEvent | Возникает при срабатывании таймера простоя (IdleTimer). |
OnLogin: TIBDatabaseLoginEvent | Возникает в момент подключения к базе данных и позволяет, например, вывести собственный диалог на подключение с последующей передачей полученных значений серверу СУБД. См. также LoginPrompt. |