ZEOS Database Objects MySQL Components |
Компонента для представления подключения к базе данных. Для использования данной компоненты необходимо присутствие динамчески загружаемой библиотеки libmysql.dll
Иерархия: TObject->TPersistent->TComponent->TZDatabase->TZMySQLDatabase
Свойства TZMySQLDatabase | |
Handle:TDirConnect | Дескриптор прямого подключения к MySQL базе данных |
Host:ShortString | Имя хоста, на котором расположена база данных |
Database:ShortString | Имя базы данных |
Login:ShortString | Имя пользователя, подключающегося к базе данных |
Password:ShortString | Пароль для подключения к базе данных |
LoginPromt:Boolean | При установке в значение true, выводится окно ввода имени и пароля пользователя |
Port:ShortString | Номер порта для подключения к MySQL серверу базы данных |
Connected:Boolean | Свойство подключенияк базе данных. При установке в значение true, происходит подключение к базе данных. То же самое делает метод Connect. |
Encoding:TEncodingType | Устанавливает локальную кодовую таблицу символов для представления содержимого базы данных. Может принимать значения:
|
Методы TZMySQLDatabase | |
procedure Connect() | Подключение к базе данных |
procedure Disconnect() | Отключение от базы данных |
События TZMySQLDatabase | |
procedure AfterConnect(Sender:TObject) | Событие происходящее после подключения к базе данных |
procedure AfterDisconnect(Sender:TObject) | Событие происходящее после отключения от базы данных |
procedure BeforeConnect(Sender:TObject) | Событие происходящее до подключения к базе данных |
procedure BeforeDisconnect(Sender:TObject) | Событие происходящее до отключения от базы данных |
Компонент для отслеживания исходящих SQL-запросов. Вызывает единственное событие OnMonitorEvent, в котором возвращается текст исходящего запроса и результат его обработки.
Иерархия: TObject->TPersistent->TComponent->TZMonitor->TZMySQLMonitor
События TZMySQLMonitor | |
procedure MonitorEvent(Sql, Result: String) | Событие происходящее после выполнения запроса. Передаваемые значения:
|
Компонент для выполнения SQL запросов к MySQL серверу. Используется для пересылки выражений SQL запросов MySQL серверу. Результаты обаботки запросов можно использовать с помощью стандартного TDataSource в виде табличного представления, при этом данные можно модифицировать, добавлять и удалять строки.
Иерархия: TObject->TPersistenet->TComponent->TDataSet->TZDataSet-> TZCustomMySQLDataSet->TZMySQLQuery
Свойства TZMySQLQuery | |
Active:Boolean | Определяет, является ли запрос открытым. При установке в значение true, запрос передается серверу и открывается DataSet. Используется только для запросов типа 'SELECT'. |
AutoCalcFields:Boolean | Определяет способ обработки вычисляемых полей |
CachedUpdates:Boolean | Определяет, кэшируются ли изменения |
DataBase:TZMySQLDatabase | Определяет базу данных, к которой буду происходить SQL запросы |
DataSource:TDataSource | Определяет DataSource, для обработки результатов запросов |
ExtraOptions:TMySQLOptions | Набор специальных параметров выполнения запросов:
|
Filter:ShortString | Определяет выражение для фильтрации записи |
Filtered:Boolean | Определяет, является ли активной фильтрация, определенная свойствами Filter или OnFilterRecord |
FilterOptions:TFilterOptions | Управляет поведением фильтров
|
LinkFields | С помощью мастера построения связанных полей, устанавливаются связи между TZMySQLQuery |
LinkOptions:TZLinkOptions | Устанавливаются параметры связывания полей
|
MasterSource:TDataSource | Устанавливает DataSource, поля которого будут являться ведущими в связывании полей |
Options:TZDatabaseOptions |
Дополнительные параметры
|
ParamCount:Word | Отражает число параметров для запроса SQL |
Params:TParams | Определяет параметры для использования с SQL-запросом |
ParamCheck:Boolean | Определяет использование параметров |
RequestLive:Boolean | Указывает, является ли результат выполнения запроса редактируемым или нет. |
RecordCount:LongInt | Возвращает число строк в DataSet |
ShowRecordTypes | Параметры просмотра записей
|
Sql:TStringList | Определяет выражения SQL для выполнения на сервере |
Transaction:TZMySQLTransact | Определяет Транзакт-сервер |
UpdateObject:TZUpdateSQL | Определяет компонент UpdateSQL для использования с кэшированием изменений |
Методы TZMySQLQuery | |
procedure ExecSql; | Выполнение запросов на изменение данных в базе данных, например: INSERT, DELETE и UPDATE |
function RowsAffected: LongInt; | Возвращает значение, соответствующее количеству записей, обработанных с помощью процедуры ExecSQL |
procedure SortInverse; | Инвертирование сортировки записей |
procedure SortClear; | Удаление сортировки записей |
procedure SortByField(FieldName: string); | Сортировка записей по полю FieldName |
procedure SortDescByField(FieldName: string); | Сортировка по убыванию по полю FieldName |
function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean; | Поиск записи, удовлетворяющей условия совпадения содержимого поля KeyFields
со значением KeyValues. При проверка совпадения учитываются следующие опции Options:
|
function Lookup(const KeyFields: string; const KeyValues: Variant; const ResultFields: string): Variant; | Аналогично Locate, но возвращает значение поля ResultFields найденной записи |
function IsSequenced: Boolean; | Признак использования номера записи для установки порядка следования записей |
procedure ApplyUpdates; | Вызов сохранения всех кэшированных изменений в базу данных. Имеет место только в случае установке свойства CachedUpdates значения True. |
procedure CommitUpdates; | Процедура сохранения всех изменений, находящихся в буфере кэша и его очистка. |
procedure CancelUpdates; | Отмена всех изменений, находящихся в буфере кэша и возвращение DataSet в прежнее состояние |
procedure RevertRecord; | Отменяет все изменения для текущей записи. |
function ParamByName(const Value: string): TParam; | Получить доступ к параметру с именем Value. |
function CreateBlobStream(Field: TField; Mode: TBlobStreamMode): TStream; | Создает поток для BLOB-поля Field, в соответствии с параметрами описаными в Mode
|
procedure SaveToStream(Stream: TStream); | Сохранение содержимого Dataset в уже созданный поток Stream |
procedure LoadFromStream(Stream: TStream); | Перенос данных из потока Stream в Dataset |
procedure SaveToFile(FileName: string); | Сохранение содержимого Dataset в файл FileName |
procedure LoadFromFile(FileName: string); | Перенос данных из файла FileName в Dataset |
События TZMySQLQuery | |
procedure AfterCancel(DataSet: TDataSet); | События вызываемое после отмены изменений внесенных в базу данных |
procedure AfterClose(DataSet: TDataSet); | События вызываемое после закрытия запроса |
procedure AfterDelete(DataSet: TDataSet); | События вызываемое после удаления записи |
procedure AfterEdit(DataSet: TDataSet); | События вызываемое после редактирования записи |
procedure AfterInsert(DataSet: TDataSet); | События вызываемое после добавления записи |
procedure AfterOpen(DataSet: TDataSet); | События вызываемое после открытия запроса |
procedure AfterPost(DataSet: TDataSet); | События вызываемое после внесения изменений в базу данных |
procedure AfterScroll(DataSet: TDataSet); | События вызываемое после после перехода на другую запись |
procedure BeforeCancel(DataSet: TDataSet); | События вызываемое до отмены изменений внесенных в базу данных |
procedure BeforeClose(DataSet: TDataSet); | События вызываемое до закрытия запроса |
procedure BeforeDelete(DataSet: TDataSet); | События вызываемое до удаления записи |
procedure BeforeEdit(DataSet: TDataSet); | События вызываемое до редактирования записи |
procedure BeforeInsert(DataSet: TDataSet); | События вызываемое до добавления записи |
procedure BeforeOpen(DataSet: TDataSet); | События вызываемое до открытия запроса |
procedure BeforePost(DataSet: TDataSet); | События вызываемое до внесения изменений в базу данных |
procedure BeforeScroll(DataSet: TDataSet); | События вызываемое до перехода на другую запись |
procedure ApplyUpdateError(DataSet: TDataSet; E: EDatabaseError; var Action: TDataAction); | Происходит при ошибке примениея всех изменений находящихся в кэше |
procedure CalcFields(DataSet: TDataSet); | Происходит , когда вычиcляемые поля нуждаются в обновлении |
procedure DeleteError(DataSet: TDataSet; E: EDatabaseError; var Action: TDataAction); | Происходит при ошибке удаления записи |
procedure EditError(DataSet: TDataSet; E: EDatabaseError; var Action: TDataAction); | Происходит при ошибке редактирования записи |
procedure FilterRecord(DataSet: TDataSet;var Accept: Boolean); | Событие вызываемое для проверки, удовлетворяет текущая запись условия фильтрации или нет |
procedure NewRecord(DataSet: TDataSet); | Происходит при создании новой записи |
procedure PostError(DataSet: TDataSet; E: EDatabaseError; var Action: TDataAction); | Происходит при ошибке сохранения изменений в текущей записи |
procedure UpdateRecord(DataSet: TDataSet; UpdateKind: TUpdateKind; var UpdateAction: TUpdateAction); | Происходит для каждой строки, сохраненной обращением к ApplyUpdates |
Компонент для обработки результатов выборки данных MySQL сервера в виде таблицы.
Иерархия: TObject->TPersistenet->TComponent->TDataSet->TZDataSet-> TZCustomMySQLDataSet->TZMySQLTable
Не имеет никаких принципиальных отличий от TZMySQLQuery, за исключением
некоторых особенностей:
Компонент для работы с транзакциями сервера MySQL.
Иерархия: TObject->TPersistent->TComponent->TZTransact->TZMySQLTransact
Свойства TZMySQLTransact | |
AutoCommit:Boolean | При установке в значение true после выполнения запроса автоматически осуществляется запись изменений. При установке свойства в false необходимо вызвать Commit или Rollback самостоятельно. |
Connected:Boolean | Индикатор подключения к базе данных |
Database:TZMySQLDatabase | Указатель на базу данных для которой осуществляется сервис транзакций |
Options:TZTransactOptions | Набор опций:
|
Методы TZMySQLTransact | |
procedure Connect | Осуществление подключения к серверу |
procedure Disconnect | Осуществление отключения от сервера |
procedure Commit | Выполнение всех изменений находящихся в буфере транзакций и его очистка |
procedure RollBack | Откат транзакции |
procedure DoApplyUpdates | Вызов сохранения всех изменений, находящихся в буфере транзакций |
События TZMySQLTransact | |
procedure OnApplyUpdates(Sender:TObject) | Событие происходящее во время применения всех изменений находящихся в буфере транзакций |
procedure OnCommit(Sender:TObject) | Событие применения изменений из буфера транзакций и его очистки |
procedure OnDataChange(Sender:TObject) | Событие изменения данных |
procedure OnRollBack(Sender:TObject) | Событие отката транзакции |