Объект Запись (ADO)

Представляет строку из набора записей или поставщика данных, или объект, возвращаемый полуструктурированным поставщиком данных, например файлом или каталогом.

Замечания

Объект Record представляет одну строку данных и имеет некоторые концептуальные сходства с набором записей одной строки. В зависимости от возможностей поставщика объекты записи могут быть возвращены непосредственно из поставщика вместо набора записей одной строки, например при выполнении SQL-запроса, который выбирает только одну строку. Или объект Record можно получить непосредственно из объекта Recordset . Кроме того, запись может быть возвращена непосредственно от поставщика к полуструктурированных данных, например поставщику OLE DB Microsoft Exchange.

Поля, связанные с объектом Record , можно просмотреть с помощью коллекции Fields в объекте Record . ADO позволяет столбцам с значением объекта, включая Recordset, SafeArray и скалярные значения в коллекции полей объектов Record .

Если объект Record представляет строку в наборе записей, можно вернуться к исходному набору записей с помощью свойства Source .

Объект Record также может использоваться частично структурированными поставщиками данных, такими как поставщик Microsoft OLE DB для публикации в Интернете, для моделирования пространств имен, структурированных в виде дерева. Каждый узел в дереве — это объект Record с связанными столбцами. Столбцы могут представлять атрибуты этого узла и другие соответствующие сведения. Объект Record может представлять как конечный узел, так и неконечный узел в структуре дерева. Неконечные узлы имеют другие узлы в качестве их содержимого, но конечные узлы не имеют такого содержимого. Конечные узлы обычно содержат двоичные потоки данных и неконечных узлов также могут иметь двоичный поток по умолчанию, связанный с ними. Свойства объекта Record определяют тип узла.

Объект Record также представляет альтернативный способ навигации по иерархически упорядоченным данным. Объект Record может быть создан для представления корня определенного подстрока в большой структуре дерева, а новые объекты Record могут быть открыты для представления дочерних узлов.

Ресурс (например, файл или каталог) можно однозначно определить по абсолютному URL-адресу. Объект Connection неявно создается и присваивается объекту Record при открытии записи с помощью абсолютного URL-адреса. Объект Connection может явно быть задан для объекта Record через свойство ActiveConnection . Доступ к файлам и каталогам, к которым можно получить доступ с помощью объекта Connection , определяет контекст , в котором могут возникнуть операции записи .

Методы изменения данных и навигации в объекте Record также принимают относительный URL-адрес, который находит ресурс с использованием абсолютного URL-адреса или контекста объекта Connection в качестве отправной точки.

Замечание

URL-адреса, использующие схему http, автоматически вызывают поставщик Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в абсолютных и относительных URL-адресов.

Объект Connection связан с каждым объектом Record . Таким образом, операции объекта Record могут быть частью транзакции путем вызова методов транзакции объекта Connection .

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

С помощью методов и свойств объекта Record можно выполнить следующие действия:

• Задайте или возвратите связанный объект Connection со свойством ActiveConnection .

• Укажите разрешения доступа с помощью свойства Mode .

• Возвращает URL-адрес каталога, который содержит ресурс, представленный записью со свойством ParentURL .

• Укажите абсолютный URL-адрес, относительный URL-адрес или набор записей , из которого извлекается запись с помощью свойства Source .

• Укажите текущее состояние записи со свойством State .

• Укажите типпростого документа Record - , коллекции или структурированного документа с помощью свойства RecordType.

• Остановите выполнение асинхронной операции с помощью метода Cancel .

• Отсоедините запись от источника данных с методом Close .

• Скопируйте файл или каталог, представленный записью , в другое расположение с помощью метода CopyRecord .

• Удалите файл или каталог и вложенные каталоги, представленные записью с помощью метода DeleteRecord .

• Откройте набор записей, содержащий строки, представляющие подкаталогы и файлы сущности, представленной методом GetChildren.

• Перемещение (переименование) файла или каталогов и подкаталогов, представленных записью в другое расположение с помощью метода MoveRecord .

• Свяжите запись с существующим источником данных или создайте новый файл или каталог с методом Open .

Объект Record безопасно для скриптов.

Этот раздел содержит следующую тему.

• Свойства объекта записи, методы и события

См. также

Коллекция полей (ADO)
Коллекция свойств (ADO)
записи и потоки
объекта набора записей