ADO RecordsetОбъект
Пример
GetRows
В этом примере показано, как использовать метод GetRows.
Объект Recordset
Объект ADO Recordset используется для хранения набора записей из таблицы базы данных. Объект Recordset состоит из записей и столбцов (полей).
В ADO этот объект является наиболее важным и наиболее часто используемым объектом для работы с данными в базе данных.
ProgID
При первом открытии Recordset указатель текущей записи указывает на первую запись, а свойства BOF и EOF имеют значение False. Если записей нет, свойства BOF и EOF имеют значение True.
Объект Recordset может поддерживать два типа обновлений:
- Немедленное обновление — как только вы вызываете метод Update, все изменения сразу записываются в базу данных. Пакетное обновление — поставщик кэширует несколько изменений, а затем использует метод UpdateBatch для передачи этих изменений в базу данных.
В ADO определены четыре различных типа курсора (указателя):
- Динамический курсор — позволяет просматривать добавления, изменения и удаления, сделанные другими пользователями.
- Курсор набора ключей — похож на динамический курсор, за исключением того, что вы не можете просматривать добавления, сделанные другими пользователями, и он не позволяет вам получать доступ к записям, удалённым другими пользователями. Изменения данных, сделанные другими пользователями, всё ещё видны.
- Статический курсор — предоставляет статическую копию набора записей, которую можно использовать для поиска данных или создания отчётов. Кроме того, добавления, изменения и удаления, сделанные другими пользователями, не будут видны. При открытии клиентского объекта Recordset это единственный допустимый тип курсора.
- Курсор только вперёд — позволяет прокручивать Recordset только вперёд. Кроме того, добавления, изменения и удаления, сделанные другими пользователями, не будут видны.
Тип курсора можно задать с помощью свойства CursorType или параметра CursorType в методе Open.
Примечание:Не все поставщики поддерживают все методы и свойства объекта Recordset.
Свойства
| Свойство | Описание |
|---|---|
| AbsolutePage | Задаёт или возвращает значение, указывающее номер страницы в объекте Recordset. |
| AbsolutePosition | Задаёт или возвращает значение, указывающее последовательную позицию (порядковую позицию) текущей записи в объекте Recordset. |
| ActiveCommand | Возвращает объект Command, связанный с объектом Recordset. |
| ActiveConnection | Если соединение закрыто, задаёт или возвращает определение соединения; если соединение открыто, задаёт или возвращает текущий объект Connection. |
| BOF | Возвращает true, если текущая позиция записи находится перед первой записью; в противном случае возвращает false. |
| Bookmark | Задаёт или возвращает закладку. Эта закладка сохраняет позицию текущей записи. |
| CacheSize | Задаёт или возвращает количество записей, которые могут быть кэшированы. |
| CursorLocation | Задает или возвращает расположение службы курсора. |
| CursorType | Задаёт или возвращает тип курсора объекта Recordset. |
| DataMember | Задаёт или возвращает имя элемента данных, которое должно быть получено из объекта, на который ссылается свойство DataSource. |
| DataSource | Указывает объект, содержащий данные, которые должны быть представлены как объект Recordset. |
| EditMode | Возвращает состояние редактирования текущей записи. |
| EOF | Возвращает true, если текущая позиция записи находится после последней записи; в противном случае возвращает false. |
| Filter | Возвращает фильтр для данных в объекте Recordset. |
| Index | Задает или возвращает имя текущего индекса объекта Recordset. |
| LockType | Задает или возвращает значение, указывающее тип блокировки при редактировании записи в Recordset. |
| MarshalOptions | Задает или возвращает значение, указывающее, какие записи возвращаются на сервер. |
| MaxRecords | Задает или возвращает максимальное число записей, возвращаемых объекту Recordset из запроса. |
| PageCount | Возвращает количество страниц данных в объекте Recordset. |
| PageSize | Задает или возвращает максимальное число записей, разрешенное на одной странице объекта Recordset. |
| RecordCount | Возвращает количество записей в объекте Recordset. |
| Sort | Задает или возвращает одно или несколько имен полей, по которым сортируется Recordset. |
| Source | Задает строковое значение или ссылку на объект Command, либо возвращает строковое значение, указывающее источник данных объекта Recordset. |
| State | Возвращает значение, описывающее, является ли объект Recordset открытым, закрытым, подключающимся, выполняющимся или извлекающим данные. |
| Status | Возвращает состояние текущей записи в отношении пакетных обновлений или других массовых операций. |
| StayInSync | Задает или возвращает, изменяется ли ссылка на дочерние записи при изменении позиции родительской записи. |
Методы
| Методы | Описание |
|---|---|
| AddNew | Создает новую запись. |
| Cancel | Отменяет выполнение. |
| CancelBatch | Отменяет пакетное обновление. |
| CancelUpdate | Отменяет изменения, внесенные в запись в объекте Recordset. |
| Clone | Создает копию существующего Recordset. |
| Close | Закрывает Recordset. |
| CompareBookmarks | Сравнивает две закладки. |
| Delete | Удаляет запись или группу записей. |
| Find | Ищет запись в Recordset, удовлетворяющую заданному условию. |
| GetRows | Копирует несколько записей из объекта Recordset в двумерный массив. |
| GetString | Возвращает Recordset в виде строки. |
| Move | Перемещает указатель записей в объекте Recordset. |
| MoveFirst | Переместить указатель записи на первую запись. |
| MoveLast | Переместить указатель записи на последнюю запись. |
| MoveNext | Переместить указатель записи на следующую запись. |
| MovePrevious | Переместить указатель записи на предыдущую запись. |
| NextRecordset | Очистить текущий объект Recordset и вернуть следующий Recordset, выполнив ряд команд. |
| Open | Открыть элемент базы данных, предоставляющий доступ к записям таблицы, результатам запроса или сохраненному Recordset. |
| Requery | Обновить данные в объекте Recordset, повторно выполнив запрос, на котором основан объект. |
| Resync | Обновить данные в текущем Recordset из исходной базы данных. |
| Save | Сохранить объект Recordset в файл или объект Stream. |
| Seek | Поиск по индексу Recordset для быстрого нахождения строки, соответствующей указанному значению, и сделать ее текущей строкой. |
| Supports | Возвращает логическое значение, определяющее, поддерживает ли объект Recordset определенный тип функциональности. |
| Update | Сохранить все изменения, внесенные в одну запись в объекте Recordset. |
| UpdateBatch | Сохранить все изменения в Recordset в базе данных. Используется в режиме пакетного обновления. |
Events
Примечание. Вы не можете использовать VBScript или JScript для обработки событий (только языки Visual Basic, Visual C++ и Visual J++ могут обрабатывать события).
| Events | Описание |
|---|---|
| EndOfRecordset | Срабатывает при попытке переместиться за конец Recordset. |
| FetchComplete | Срабатывает после чтения всех записей в асинхронной операции. |
| FetchProgress | Срабатывает периодически во время асинхронной операции, сообщая, сколько записей было прочитано. |
| FieldChangeComplete | Срабатывает при изменении значения объекта Field. |
| MoveComplete | Срабатывает после изменения текущей позиции в Recordset. |
| RecordChangeComplete | Срабатывает после изменения записи. |
| RecordsetChangeComplete | Срабатывает после изменения Recordset. |
| WillChangeField | Срабатывает до изменения значения объекта Field. |
| WillChangeRecord | Срабатывает до изменения записи. |
| WillChangeRecordset | Срабатывает до изменения Recordset. |
| WillMove | Срабатывает до изменения текущей позиции в Recordset. |
Коллекции
| Set | Описание |
|---|---|
| Fields | Указывает количество объектов Field в этом объекте Recordset. |
| Свойства | Содержит объекты Property во всех объектах Recordset. |
Свойства коллекции Fields
| Attribute | Описание |
|---|---|
| Count |
Возвращает количество элементов в коллекции fields. Начинается с 0. Пример: countfields = rs.Fields.Count |
| Item(named_item/number) |
Возвращает указанный элемент в коллекции Fields. Пример: itemfields = rs.Fields.Item(1) 或者 itemfields = rs.Fields.Item("Name") |
Свойства коллекции Properties
| атрибут | Описание |
|---|---|
| Count |
Возвращает количество элементов в коллекции properties. Начинается с 0. Пример: countprop = rs.Properties.Count |
| Item(named_item/number) |
Возвращает указанный элемент в коллекции properties. Пример: itemprop = rs.Properties.Item(1) 或者 itemprop = rs.Properties.Item("Name") |