ADO RecordsetОбъект


Пример

GetRows
В этом примере показано, как использовать метод GetRows.


Объект Recordset

Объект ADO Recordset используется для хранения набора записей из таблицы базы данных. Объект Recordset состоит из записей и столбцов (полей).

В ADO этот объект является наиболее важным и наиболее часто используемым объектом для работы с данными в базе данных.

ProgID

set objRecordset=Server.CreateObject("ADODB.recordset")

При первом открытии 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")
Другие расширения.