Объект Record (ADO)
Представляет строку из набора записей или поставщика данных, или объект, возвращаемый полуструктурированным поставщиком данных, например файлом или каталогом.
Замечания
Объект Record представляет одну строку данных и имеет некоторые концептуальные сходства с набором записей одной строки. В зависимости от возможностей поставщика объекты записи могут быть возвращены непосредственно из поставщика вместо набора записей одной строки, например при выполнении SQL-запроса, который выбирает только одну строку. Или объект Record можно получить непосредственно из объекта Recordset. Кроме того, запись может быть возвращена непосредственно от поставщика к полуструктурированных данных, например поставщику OLE DB Microsoft Exchange.
Поля, связанные с объектом Record, можно просмотреть с помощью коллекции Fields в объекте Record. ADO позволяет столбцам с значением объекта, включая Recordset, Сейф Array и скалярные значения в коллекции полей объектов Record.
Если объект Record представляет строку в наборе записей, можно вернуться к исходному набору записей с помощью свойства Source.
Объект Record также может использоваться частично структурированными поставщиками данных, такими как поставщик Microsoft OLE DB для публикации в Интернете, для моделирования пространств имен, структурированных в виде дерева. Каждый узел в дереве — это объект Record с связанными столбцами. Столбцы могут представлять атрибуты этого узла и другие соответствующие сведения. Объект Record может представлять как конечный узел, так и неконечный узел в структуре дерева. Неконечные узлы имеют другие узлы в качестве их содержимого, но конечные узлы не имеют такого содержимого. Конечные узлы обычно содержат двоичные потоки данных и неконечных узлов также могут иметь двоичный поток по умолчанию, связанный с ними. Свойства объекта Record определяют тип узла.
Объект Record также представляет альтернативный способ навигации по иерархически упорядоченным данным. Объект Record может быть создан для представления корня определенного подстрока в большой структуре дерева, а новые объекты Record могут быть открыты для представления дочерних узлов.
Ресурс (например, файл или каталог) можно однозначно определить по абсолютному URL-адресу. Объект Подключение ion неявно создается и присваивается объекту Record при открытии записи с помощью абсолютного URL-адреса. Объект Подключение ion может быть явно задан для объекта Record через свойство Active Подключение ion. Файлы и каталоги, к которым можно получить доступ с помощью объекта Подключение ion, определяют контекст, в котором могут выполняться операции записи.
Методы изменения данных и навигации в объекте Record также принимают относительный URL-адрес, который находит ресурс с помощью абсолютного URL-адреса или контекста объекта Подключение ion в качестве отправной точки.
Примечание.
URL-адреса, использующие схему http, автоматически вызывают поставщика Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в разделе "Абсолютные и относительные URL-адреса".
Объект Подключение ion связан с каждым объектом Record. Таким образом, операции объекта Record могут быть частью транзакции, вызывая методы транзакций объекта Подключение ion.
Объект Record не поддерживает события ADO, поэтому не будет отвечать на уведомления.
С помощью методов и свойств объекта Record можно выполнить следующие действия:
Задайте или возвращает связанный объект Подключение ion со свойством Active Подключение ion.
Укажите разрешения доступа с помощью свойства Mode .
Возвращает URL-адрес каталога, который содержит ресурс, представленный записью со свойством ParentURL .
Укажите абсолютный URL-адрес, относительный URL-адрес или набор записей, из которого извлекается запись с помощью свойства Source .
Укажите текущее состояние записи со свойством State .
Укажите тип простого документа Record - , коллекции или структурированного документа с помощью свойства RecordType.
Остановите выполнение асинхронной операции с помощью метода Cancel .
Отсоедините запись от источника данных с методом Close .
Скопируйте файл или каталог, представленный записью, в другое расположение с помощью метода CopyRecord.
Удалите файл или каталог и вложенные каталоги, представленные записьюс помощью метода DeleteRecord .
Откройте набор записей, содержащий строки, представляющие подкаталогы и файлы сущности, представленнойметодом GetChildren.
Перемещение (переименование) файла или каталогов и подкаталогов, представленных записью в другое расположение с помощью метода MoveRecord .
Свяжите запись с существующим источником данных или создайте новый файл или каталог с методом Open .
Объект Record является безопасным для сценариев.
Этот раздел содержит следующий раздел.
См. также
Коллекция Fields (ADO)
Коллекция Properties (ADO)
Записи и потоки
Объект Recordset (ADO)