Объект 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)