Записи и предоставляемые поставщиком поля
При открытии объекта Record его источником может быть текущая строка открытого набора записей, абсолютный URL-адрес или относительный URL-адрес в сочетании с открытым объектом Connection .
Если запись открывается из набора записей, коллекция Поля объекта Record будет содержать все поля из набора записей, а также все поля, добавленные базовым поставщиком.
Поставщик может вставить дополнительные поля, которые служат дополнительными характеристиками записи. В результате запись может иметь уникальные поля, отсутствуют в наборе записей в целом или записи, производные от другой строки набора записей.
Например, все строки набора записей , производного от источника данных электронной почты, могут содержать такие столбцы, как From, To и Subject. Запись, производная от этого набора записей, будет содержать те же поля. Однако запись может также содержать другие поля, уникальные для конкретного сообщения, представленного этой записью, например Вложение и Копия (копия).
Хотя объект Record и текущая строка объекта Recordset имеют одинаковые поля, они различаются, так как объекты Record и Recordset имеют разные методы и свойства.
Поле, храняное в общих записях Record и Recordset , может быть изменено в любом объекте. Однако это поле нельзя удалить в объекте Record , хотя базовый поставщик может поддерживать установку для поля значения NULL.
После открытия записи можно добавить поля программными средствами. Вы также можете удалить добавленные поля, но нельзя удалить поля из исходного набора записей.
Вы также можете открыть объект Record непосредственно из URL-адреса. В этом случае поля, добавленные в запись , зависят от базового поставщика. В настоящее время большинство поставщиков добавляют набор полей, описывающих сущность, представленную записью. Если сущность состоит из потока байтов, например простого файла, объект Stream обычно можно открыть из элемента Record.
Специальные поля для поставщиков источников документов
Специальный класс поставщиков, называемый поставщиками источников документов, управляет папками и документами. Если объект Record представляет документ, или объект Recordset представляет папку документов, поставщик источника документов заполняет эти объекты уникальным набором полей, описывающих характеристики документа, а не самого документа. Как правило, одно поле содержит ссылку на поток , представляющий документ.
Эти поля представляют собой запись ресурса или набор записей и перечислены для конкретных поставщиков, которые их поддерживают в приложении А. Поставщики.
Две константы индексируют коллекцию Fields ресурса Record или Recordset , чтобы получить пару часто используемых полей. Свойство Field object Value возвращает требуемое содержимое.
Поле, к которым обращается константа adDefaultStream , содержит поток по умолчанию, связанный с объектом Record или Recordset . Поставщик назначает объекту поток по умолчанию.
Поле, к которому обращается константа adRecordURL , содержит абсолютный URL-адрес, идентифицирующий документ.
Поставщик источника документов не поддерживает коллекцию Properties объектов Record и Field . Содержимое коллекции Properties для таких объектов равно NULL.
Поставщик источника документа может добавить свойство конкретного поставщика, например Тип источника данных , чтобы определить, является ли он поставщиком источника документов. Дополнительные сведения об определении типа поставщика см. в документации по поставщику.
Столбцы набора записей ресурсов
Набор записей ресурсов состоит из следующих столбцов.
| Имя столбца | Тип | Описание |
|---|---|---|
| RESOURCE_PARSENAME | AdVarWChar | Только для чтения. Указывает URL-адрес ресурса. |
| RESOURCE_PARENTNAME | AdVarWChar | Только для чтения. Указывает абсолютный URL-адрес родительской записи. |
| RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | Только для чтения. Указывает абсолютный URL-адрес ресурса, который является объединением PARENTNAME и PARSENAME. |
| RESOURCE_ISHIDDEN | AdBoolean | Значение true, если ресурс скрыт. Строки не будут возвращены, если команда, создающая набор строк, явно не выберет строки, в которых RESOURCE_ISHIDDEN имеет значение True. |
| RESOURCE_ISREADONLY | AdBoolean | Значение true, если ресурс доступен только для чтения. Попытка открыть этот ресурс с помощью DBBINDFLAG_WRITE и сбой при DB_E_READONLY. Это свойство можно изменить, даже если ресурс открыт только для чтения. |
| RESOURCE_CONTENTTYPE | AdVarWChar | Указывает на вероятное использование документа, например краткого документа адвоката. Это может соответствовать шаблону Office, который использовался для создания документа. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Указывает тип MIME документа, указывающий формат, например "text/html". |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Указывает язык, на котором хранится содержимое. |
| RESOURCE_CREATIONTIME | adFileTime | Только для чтения. Указывает структуру FILETIME, содержащую время создания ресурса. Время указывается в формате UTC. |
| RESOURCE_LASTACCESSTIME | AdFileTime | Только для чтения. Указывает структуру FILETIME, содержащую время последнего доступа к ресурсу. Время в формате UTC. Элементы FILETIME равны нулю, если поставщик не поддерживает этот элемент времени. |
| RESOURCE_LASTWRITETIME | AdFileTime | Только для чтения. Указывает структуру FILETIME, содержащую время последней записи ресурса. Время в формате UTC. Элементы FILETIME равны нулю, если поставщик не поддерживает этот элемент времени. |
| RESOURCE_STREAMSIZE | asUnsignedBigInt | Только для чтения. Указывает размер потока ресурса по умолчанию в байтах. |
| RESOURCE_ISCOLLECTION | AdBoolean | Только для чтения. Значение true, если ресурс является коллекцией, например каталогом. False, если ресурс является простым файлом. |
| RESOURCE_ISSTRUCTUREDDOCUMENT | AdBoolean | Значение true, если ресурс является структурированным документом. False, если ресурс не является структурированным документом. Это может быть коллекция или простой файл. |
| DEFAULT_DOCUMENT | AdVarWChar | Только для чтения. Указывает, что этот ресурс содержит URL-адрес простого документа папки или структурированного документа по умолчанию. Используется при запросе потока по умолчанию из ресурса. Это свойство пусто для простого файла. |
| CHAPTERED_CHILDREN | AdChapter | Только для чтения. Необязательный элемент. Указывает главу набора строк, которая содержит дочерние элементы ресурса. ( Поставщик OLE DB для публикации в Интернете не использует этот столбец.) |
| RESOURCE_DISPLAYNAME | AdVarWChar | Только для чтения. Указывает отображаемое имя ресурса. |
| RESOURCE_ISROOT | AdBoolean | Только для чтения. Значение true, если ресурс является корнем коллекции или структурированного документа. |