Примеры
GetRows
Этот пример показывает, как использовать метод GetRows.
Recordset объект
Объект Recordset ADO используется для хранения набора записей из таблицы базы данных. Объект Recordset состоит из записей и столбцов (fields) .
В ADO, этот объект является самым важным и тот, чаще всего используется для работы с данными из базы данных.
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
При первом открытии Recordset, текущий указатель записи будет указывать на первую запись и BOF и EOF свойства значение False. Если нет записей, то BOF и EOF свойство истинны.
Recordset объекты могут поддерживать два типа обновления:
- Immediate updating - все изменения записываются непосредственно в базу данных после вызова метода Update.
- Batch updating - провайдер будет кэшировать несколько изменений , а затем отправить их в базу данных с помощью метода UpdateBatch.
В ADO есть 4 различных типа курсора определены:
- Dynamic cursor - Позволяет увидеть дополнения, изменения и удаления другими пользователями.
- Keyset cursor - Как динамический курсор, за исключением того, что вы не можете увидеть дополнение от других пользователей, и предотвращает несанкционированный доступ к записям , которые другие пользователи удалены. Изменения данных по другим пользователям все равно будут видны.
- Static cursor - Обеспечивает статическую копию записей для вас использовать , чтобы найти данные или генерировать отчеты. Дополнения, изменения или удаления от других пользователей не будут видны. Это единственный тип курсора разрешается при открытии объекта Recordset на стороне клиента.
- Forward-only cursor - Позволяет только прокручивать вперед через Recordset. Дополнения, изменения или удаления от других пользователей не будут видны.
Тип курсора может быть установлен с помощью свойства CursorType или параметр CursorType в открытом методе.
Note: Не все поставщики поддерживают все методы и свойства объекта Recordset.
свойства
| Имущество | Описание |
|---|---|
| AbsolutePage | Устанавливает или возвращает значение, указывающее номер страницы в объекте Recordset |
| AbsolutePosition | Устанавливает или возвращает значение, указывающее порядковый номер текущей записи в объекте Recordset |
| ActiveCommand | Возвращает объект Command, связанный с Recordset |
| ActiveConnection | Устанавливает или возвращает определение для соединения, если соединение закрывается, или текущий объект Connection, если соединение открыто |
| BOF | Возвращает истину, если текущая позиция записи перед первой записью, в противном случае лжи |
| Bookmark | Устанавливает или возвращает закладку. Закладка сохраняет положение текущей записи |
| CacheSize | Устанавливает или возвращает количество записей, которые могут быть в кэше |
| CursorLocation | Устанавливает или возвращает расположение службы курсора |
| CursorType | Устанавливает или возвращает тип курсора объекта Recordset |
| DataMember | Устанавливает или возвращает имя элемента данных, которые будут извлечены из объекта на который ссылается свойство DataSource |
| DataSource | Указывает объект, содержащий данные, которые будут представлены в виде объекта Recordset |
| EditMode | Возвращает статус редактирования текущей записи |
| EOF | Возвращает истину, если текущая позиция записи после последней записи, в противном случае лжи |
| 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 с помощью повторного выполнения запроса, который сделал оригинальный Recordset |
| Resync | Обновляет данные в текущем Recordset из исходной базы данных |
| Save | Сохраняет объект Recordset в файл или объект потока |
| Seek | Ищет индекс в Recordset найти запись, соответствующую заданные значения |
| Supports | Возвращает логическое значение, которое определяет, поддерживает ли объект Recordset определенного типа функциональности |
| Update | Сохраняет все изменения, сделанные в одной записи в Recordset объекта |
| UpdateBatch | Сохраняет все изменения в Recordset в базе данных. Используется при работе в режиме пакетного обновления |
Мероприятия
Note: Вы не можете обрабатывать события с помощью VBScript или JScript (только Visual Basic, Visual C ++ и языки Visual J ++ может обрабатывать события).
| Мероприятие | Описание |
|---|---|
| EndOfRecordset | Срабатывает при попытке перейти на запись после последней записи |
| FetchComplete | Вызывается после того, как все записи в асинхронной операции были извлечены |
| FetchProgress | Срабатывание периодически в асинхронном режиме, чтобы указать, как многие другие записи, которые были извлечены |
| FieldChangeComplete | Срабатывает после значения изменения объекта поля |
| MoveComplete | Вызывается после того, как текущее положение в Recordset изменилось |
| RecordChangeComplete | Вызывается после того, как запись изменилась |
| RecordsetChangeComplete | Вызывается после того, как Recordset изменился |
| WillChangeField | Срабатывание до величины изменения объекта поля |
| WillChangeRecord | Срабатывает до изменения записи |
| WillChangeRecordset | Срабатывает до изменения Recordset |
| Будет двигаться | Срабатывает до текущей позиции в изменениях Recordset |
Коллекции
| Коллекция | Описание |
|---|---|
| Fields | Указывает количество объектов поля в объекте Recordset |
| Properties | Содержит все объекты собственности в объекте Recordset |
Свойства Поля коллекции
| Имущество | Описание |
|---|---|
| Count | Возвращает количество элементов в коллекции полей. Начинается с нуля. Пример: countfields = rs.Fields.Count |
| Item(named_item/number) | Возвращает указанный элемент в коллекции полей. Пример: itemfields = rs.Fields. Item(1) |
Свойства от свойств коллекции
| Имущество | Описание |
|---|---|
| Count | Возвращает количество элементов в коллекции свойств. Начинается с нуля. Пример: countprop = rs.Properties.Count |
| Item(named_item/number) | Возвращает указанный элемент в коллекции свойств. Пример: itemprop = rs.Properties. Item(1) |