Объект Record (ADO)

Область применения: Access 2013, Office 2013

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

Замечания

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

Поля, связанные с объектом Record , можно просмотреть с помощью коллекции Fields объекта Record . ADO позволяет использовать объектно-значные столбцы, включая Recordset, SafeArray и скалярные значения в коллекции Fields объектов 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 .

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

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

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

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

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

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

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

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