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

Ниже рассмотрены основные, кроме рассмотренных ранее, свойства компонента ADODataSet

• Active - Это свойство обеспечивает открытие набора данных при установке в true и его закрытие при установке в false.

• BlockReadSize - Этим свойством определяется число записей, составляющих один блок. Это свойство позволяет организовать пересылку записей по блокам, что ускоряет процесс передачи данных. По умолчанию свойство имеет значение 0, и блочная пересылка не применяется. Если же изменить значение свойства, то набор данных автоматически перейдет в состояние dsBlockRead (свойство State). Блочная пересылка может быть использована в тех случаях, когда нет необходимости отображать данные в визуальных компонентах.

• CacheSize – Это свойство определяет размер буфера, в котором размещаются данные после передачи их клиенту. Это свойство задает число записей, которые будут помещаться в буфер. По умолчанию это свойство имеет значение 1 и не может быть меньше.

• Connection - Это свойство ссылается на компонент ADOConnection, с помощью которого обеспечивается связь с базой данных.

• ConnectionString - Это свойство обеспечивает доступ к базе данных при непосредственном задании строки соединения.

• CursorLocation - Это свойство определяет, где будет находится курсор, на сервере или на клиентской стороне.

• ExecuteOptions - Это свойство определяет способ выполнения команды. Это свойство может принимать такие же значения, как и одноименное свойство компонента ADOCommand. (более подробно см. ниже)/

• MaxRecords - Это свойство позволяет задать максимальное число записей набора данных. По умолчанию это свойство равно 0 (таким образом, набор данных не ограничен).

• LockType - Это свойство задает тип блокировки, используемый при редактировании записей (например, блокировка на время сохранения или на время редактирования, включение режима только для чтения и т. д.)

• RecordCount - Это свойство содержит сведения о количестве записей, содержащихся в наборе данных, в текущий момент времени.

• RecordSize - Это свойство позволяет узнать размер одной записи в байтах.

• RecordsetState - Это свойство дает возможность определить текущее состояние набора данных. Значения этого свойства аналогичны значениям свойства State компонента соединения ADOConnection.

• RecordStatus - Это свойство служит для определения состояния текущей записи набора данных (например, позволяет узнать, что запись была добавлена, удалена, изменена, сохранена или не сохранена по различным причинам).

• State - Это свойство определяет состояние набора данных в текущий момент времени (например, dslnactivate -набор данных закрыт, dsBrowse - набор данных в состоянии просмотра, dsEdit - редактирование записи, dsInsert - вставка записи, dsSetKey -поиск записи, dsBlockRead - чтение блока записей и т. д.). Это свойство доступно только для чтения при выполнении приложения

Рассмотрим еще некоторые важные свойства Компонента ADODataSet.

• CursorType- Это свойство устанавливает один из таких типов курсора (в ADO курсор представляет собой возвращаемый клиентскому приложению набор записей таблицы базы данных и связанный с ним указатель текущей записи):

• ctOpenForwardOnly - однонаправленный курсор, обеспечивающий перемещение по таблице базы данных только вперед. Этот курсор потребляет минимум ресурсов, поскольку после перехода на следующую запись ресурсы, связанные с предыдущей записью освобождаются, и она больше не может быть прочитана. Данный тип курсора используется обычно для отчетов и анализа данных без их изменения;

• ctStatic - статический курсор, который показывает данные в том состоянии, в котором они были в момент открытия курсора(т.е. курсор не отображает изменения данных, внесенных другими пользователями, до тех пор, пока набор данных не будет открыт заново). При использовании данного курсора допускается перемещение по набору данных как вперед, так и назад;

• ctDynamic - динамический курсор, располагаемый, как правило, на стороне, сервера. Данные, измененные другими пользователями, обновляются в таком курсоре автоматически. Динамический курсор потребляет максимум ресурсов. Этот тип курсора поддерживается не всеми поставщиками данных. Он позволяет перемещаться по записям набора данных в двух направлениях - вперед и назад;

• ctKeyset - курсор, который представляет собой нечто среднее между статическими и динамическими курсорами. При использовании этого типа курсора запоминаются ключевые поля всех записей на момент его открытия. Изменения, внесенные другими пользователями, видны, если они не изменяют ключевые поля. Записи, добавленные другими пользователями, не видны до тех пор, пока курсор не будет открыт повторно. При удалении записи ключевое поле записи сохраняется в курсоре, хотя сама запись в таблице уже отсутствует. Этот тип курсоров лучше использовать, если записи преимущественно изменяются, а не удаляются и добавляются;

• ctUnspecified - курсор не определен, его тип определяется источником данных.

• Свойство Sort обеспечивает возможность сортировки по произвольно заданному набору полей. Поля указываются через запятую. Помимо этого, дополнительно может устанавливаться признак прямого (ASC) или обратного (DESC) порядка сортировки. Если порядок не указан, то по умолчанию сортировка осуществляется по возрастанию, например:

ADODataSet.Sort:"= 'Fieldl DESC, Field2 ASC, Fields¹;

В данном случае сортировка вначале осуществляется в порядке убывания по полю Fieldl, затем в порядке возрастания по полю Field2 и, наконец, в порядке возрастания по полю Fields.

• Свойство Parameters обеспечивает возможность задания параметров SQL-запроса или хранимой процедуры. Данное свойство является объектом класса TParameters и в свою очередь обладает собственным набором свойств. Важнейшими из них являются:

• Items — представляет собой индексированный список, который позволяет обращаться к параметрам по их порядковым номерам;

• ParamValues - позволяет получить текущие значения указанных параметров.

Доступ к конкретному значению обеспечивается по имени параметра, например:

Editl.Text:= ADODataSetl. Parameters. ParamValues['Paraml'];

Это свойство обеспечивает возможность передачи параметров в запрос, на основе которого формируется набор данных.

Среди методов класса TParameters можно выделить следующие:

• Метод CreateParameter(const Name: WideString; DataType: TDats-Type; Direction: TParameterDirection; Size: Integer; Value: OleVa--ant): TParameter создает новый параметр и задает его свойства.

Здесь:

• Name — имя параметра;

• DataType - тип значения параметра, который должен соответствовать типу поля таблицы БД;

• Direction — направление передачи данных через параметр (подробнее см. ниже);

• Size - максимальный размер значения параметра строкового типа (иными словами, длина строки для параметров типа String);

• Value — значение параметра.

• Метод AddParameter: TParameter добавляет к списку новый параметр. После этого должны быть дополнительно установлены все необходимые свойства нового параметра.

• Метод ParamByName(const Value: WideString): TParameter обеспечивает возможность обращения к параметру по его имени, а не по индексу.

• Метод Refresh служит для обновления списка параметров, чтобы он соответствовал запросу или хранимой процедуре.

Для каждого параметра из списка TParameters создается отдельный объект класса TParameter. Этот объект также обладает собственным набором свойств и методов, самыми важными из которых являются следующие:

• Свойства Name, DataType, Size, Value аналогичны одноименным параметрам рассмотренного выше метода CreateParameter.

• Свойство Attributes задает список атрибутов, которые определяют, допустимы ли некоторые специальные значения параметра. Это свойство может принимать комбинацию таких значений:

• paSigned - значение параметра может иметь знаковые различия, т. е. быть как положительным, так и отрицательным;

• paNullable — значение параметра может быть пустым;

• paLong - параметр может содержать двоичные данные.

Свойство Direction устанавливает направление передачи данных через параметр и может иметь одно из следующих значений:

• pdllnknown - неизвестный тип параметра, который будет определяться самим источником данных;

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

• pdOutput - выходной параметр, который применяется в хранимых процедурах;

• pdlnputOutput - параметр является входным и выходным одновременно (обычно используется в хранимых процедурах);

• pdReturnValue - параметр используется для передачи возвращаемого значения.

• Метод LoadFromFile(const FileName: String; DataType: TDataType) класса TParameter позволяет загрузить значение параметра из файла.Метод LoadFromStream(Stream: TStream; DataType: TDataType) класса TParameter обеспечивает возможность загрузки значения параметра из потока класса TStream.