Visual Basic 6. Руководство разработчика

Свойства элемента управления


Data

К наиболее важным свойствам элемента управления

Data можно отнести свой­ства, перечисленные ниже.

• DatabaseName (Имя базы данных). Определяет используемую базу данных.

•  RecordSource (Источник записей). Определяет выбранную для использования часть базы данных.

В любой момент времени Data установлен на единственную строку (запись) в наборе RecordSet. Пользователь может перемещаться на другую запись с помощью кнопок перемещения, расположенных на элементе управления Data.

Каждый элемент управления TextBox связан с одним полем текущей строки. При установке Data на другую запись в RecordSet элементы TextBox обновляются. При изменении данных в TextBox новое значение записывается в базу данных, когда Data устанавливается на другую запись. Элемент управления TextBox соединен с полем в RecordSet с помощью Data и называется связанным с данными (он связан с полем в наборе записей RecordSet).

Ниже приведены наиболее важные свойства элементов управления, связанных с данными.

•  DataSource (Источник данных). Это имя элемента управления Data. Посредством этого имени элементы управления (например, TextBox и CheckBox) связываются с элементом Data. Другими словами, это имя элемента управления Data, с помощью которого связанные с данными элементы "видят" базу данных.

•  DataField (Поле). Это имя поля в наборе RecordSet, которое отображается и обновляется (в случае изменения) в элементе управления.

Примечание

Элемент управления TextBox, связанный с конкретным полем, называется связанным с данными. Существуют другие элементы управления, которые можно связывать с набором записей элемента управления Data. Чтобы предотвратить редактирование содержимого таблицы, используются элементы управления Label. Если таблица содержит логические поля (принимающие только значения True или False), то можно связывать их с элементами управления CheckBox (флажок). Некоторые общие элементы управления не связываются с данными. Например, элемент ListBox. Фирма Microsoft предоставляет его расширенную версию — связанный с данными ListBox, который автоматически заполняется значениями из столбца набора записей. Позже мы рассмотрим, как использовать эти элементы управления в приложениях.




Можно устанавливать в окне свойств или использовать в тексте программ (с целью управления) следующие свойства элемента управления Data.
EOF (Конец файла).
Возвращает значение True или False, которое указывает, находится ли текущая позиция записи после последней записи в объекте RecordSet.
BOF (Начало файла).
Возвращает значение True или False, которое указывает, находится ли текущая позиция записи перед первой записью в объекте RecordSet.
BOFAction.
Устанавливает или возвращает значение, указывающее, какое действие должен произвести элемент управления Data, когда свойство BOF равно True. Эти действия перечислены в табл. 17.1.
Таблица 17.1. Значения, возвращаемые свойством BOFAction

Константа
Значение
Действие
vbBOFActionMoveFirst
VbBOFActionBOF
0
1
Устанавливает управление на первую запись (значение по умолчанию).
Перемещает управление в начало RecordSet и устанавливает на несуществующую запись с одновременным вызовом события Validate элемента Data для первой записи. Далее показано, как обработать данную ситуацию.

EOFAction.
Устанавливает или возвращает значение, указывающее, какое действие должен произвести элемент управления Data, когда свойство EOF равно True (табл. 17.2).
ReadOnly.
Возвращает или устанавливает значение, определяющее, открыт ли объект RecordSet только для чтения.
RecordsetType.
Возвращает или устанавливает значение, задающее тип RecordSet, создаваемый Data. Может иметь одно из значений, приведенных в табл. 17.3.
Options.
Устанавливает одну или более характеристик объекта RecordSet. Возможные значения этого свойства приведены в табл. 17.4.
Таблица 17.2. Значения, возвращаемые свойством EOFAction

Константа
Значение
Действие
vbEOFActionMoveLast
vbEOFActionEOF
Vb EO FActionAddN ew
0
1
2
Устанавливает управление на последнюю запись (значение по умолчанию)
Перемещает управление в конец RecordSet и устанавливает на недействительной записи с одновременным вызовом события Validate элемента Data для последней записи. Позже рассмотрим, как обработать данную ситуацию
Добавляет новую пустую запись в RecordSet, которую пользователь может редактировать. Новая запись в базу данных записывается при переходе элемента управления Data на другую запись
<


Таблица 17.3. Значения свойства RecordsetType

Константа
Значение
Описание
vbRSTypeTable vbRSTypeDynaset vbRSTypeSnapshot
0
1
2
Типа Table
Типа DynaSet (по умолчанию)
Типа SnapShot

Таблица 17.4. Значения свойства Options

Константа
Значение
Описание
dbDenyWrite
1
В многопользовательской среде другие пользователи не могут изменить записи в RecordSet
DbDenyRead
2
В многопользовательской среде другие пользователи не могут читать записи (Только для RecordSet типа Table)
DbReadOnly
4
Пользователь приложения читает, но не может изменять записи в RecordSet
DbAppendOnly
8
Пользователь приложения добавляет новые записи в RecordSet, но не может читать
существующие
Dblnconsistent
16
Обновления применяется ко всем полям RecordSet, даже если они нарушают условие объединения (применяется к RecordSets, основанных на SQL-запросах)
DbConsistent
32
Обновления применяются к полям, которые не нарушают условие объединения (применяется в RecordSets, основанных на SQL-запросах) (по умолчанию)
DbSQLPassThrough
64
Когда используется элемент Data с SQL-оператором в свойстве RecordSource, передает SQL-запрос базе данных, поддерживаемой ODBC (например, SQL Server или Oracle)
DbForwardOnly
256
Объект RecordSet поддерживает только прокрутку вперед. MoveNext — единственный разрешенный метод перемещения. Эта опция не используется в объектах RecordSet, управляемых элементом Data
DbSeeChanges
512
Генерирует блокируемую (trappable) ошибку, если другой пользователь изменяет данные, которые вы редактируете

Bookmark. Свойство типа Variant, идентифицирующее строку в RecordSet. Каждая строка имеет собственную, уникальную закладку, которая не связана с порядком записей в RecordSet. Сохраните свойство Bookmark в переменной, чтобы можно было вернуться к этой записи, присвоив свойству Bookmark данную переменную.

Содержание раздела