Записи и поля Provider-Supplied
При открытии объекта Record его источник может быть текущей строкой открытого набора записей , абсолютным URL-адресом или относительным URL-адресом в сочетании с открытым объектом Connection.
Если запись открыта из набора записей , коллекция полей объекта Record будет содержать все поля из набора записей , а также любые дополнительные поля, добавленные базовым поставщиком.
Поставщик может вставить дополнительные поля, которые служат в качестве дополнительных характеристик записи . В результате запись может иметь уникальные поля, которые отсутствуют в наборе записей в целом или в любой записи, полученной из другой строки набора записей.
Например, все строки набора записей , производные от источника данных электронной почты, могут иметь такие столбцы, как From, To и Subject. Запись , производная от этого набора записей , будет иметь такие же поля. Однако записи могут также иметь другие поля, уникальные для конкретного сообщения, представленного этим записью, например вложение и копия (углеродная копия).
Хотя объект Record и текущая строка набора записей Recordset имеют одинаковые поля, они отличаются, так как объекты Record и Recordset имеют разные методы и свойства.
Поле, являющееся общим для записи и набора записей , можно изменить в любом из объектов. Однако поле нельзя удалить в объекте Record, хотя базовый поставщик может поддерживать установку поля на значение NULL.
После открытия записи можно программным способом добавить поля. Вы также можете удалить добавленные поля, но вы не можете удалить поля из исходного набора записей .
Вы также можете открыть объект записи непосредственно из URL-адреса. В этом случае поля, добавленные в запись , зависят от базового поставщика. В настоящее время большинство поставщиков добавляют набор полей, которые описывают сущность, представленную записью . Если сущность состоит из потока байтов, например простого файла, объект Stream stream обычно можно открыть из записи.
Специальные поля для поставщиков источников документов
Специальный класс поставщиков, называемый поставщиков источников документов, управляет папками и документами. Если объект записи представляет документ или объект Recordset представляет папку документов, поставщик источника документов заполняет эти объекты уникальным набором полей, описывающих характеристики документа, а не фактический документ. Как правило, одно поле содержит ссылку на Stream, представляющую документ.
Эти поля образуют запись ресурса или набор записей и перечислены для конкретных поставщиков, которые поддерживают их в Приложении A: Провайдеры.
Две константы индексируют коллекцию полей ресурса для записи или набора записей , чтобы получить пару часто используемых полей. Объект FieldValue возвращает требуемое содержимое.
Поле, к которому обращается константа adDefaultStream, содержит поток по умолчанию, связанный с объектом Record или Recordset. Поставщик назначает поток по умолчанию объекту.
Поле, к которому обращается adRecordURL, содержит абсолютный URL-адрес, определяющий документ.
Поставщик источника документов не поддерживает коллекцию свойств объектов записи и поля . Содержимое коллекции свойств имеет значение NULL для таких объектов.
Поставщик источника документов может добавить свойство для конкретного поставщика, например тип источника данных, чтобы определить, является ли он поставщиком источника документов. Дополнительные сведения о том, как определить тип поставщика, см. в документации по поставщику.
Столбцы ресурсного набора записей
Набор записей ресурсов состоит из следующих столбцов.
| Имя столбца | Тип | Описание |
|---|---|---|
| RESOURCE_PARSENAME | AdVarWChar | Только для чтения. Указывает URL-адрес ресурса. |
| RESOURCE_PARENTNAME | AdVarWChar | Только для чтения. Указывает абсолютный URL-адрес родительской записи. |
| RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | Только для чтения. Указывает абсолютный URL-адрес ресурса, который является объединением PARENTNAME и PARSENAME. |
| RESOURCE_ISHIDDEN | AdBoolean | Истинно, если ресурс скрыт. Никакие строки не будут возвращены, если команда, которая создает набор строк, явно выбирает строки, в которых RESOURCE_ISHIDDEN имеет значение True. |
| РЕСУРС_ТОЛЬКО_ДЛЯ_ЧТЕНИЯ | AdBoolean | Истина, если ресурс доступен только для чтения. Пытается открыть этот ресурс с DBBINDFLAG_WRITE и получит ошибку DB_E_READONLY. Это свойство можно изменить, даже если ресурс был открыт только для чтения. |
| ТИП_КОНТЕНТ_РЕСУРСА | AdVarWChar | Указывает на вероятное использование документа, например, юридического заключения. Это может соответствовать шаблону Office, который использовался для создания документа. |
| RESOURCE_CONTENTCLASS (КЛАСС_СОДЕРЖАНИЯ_РЕСУРСА) | AdVarWChar | Указывает тип MIME документа, указывающий формат, например "text/html". |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Указывает язык, в котором хранится содержимое. |
| ВРЕМЯ_СОЗДАНИЯ_РЕСУРСА | adFileTime | Только для чтения. Указывает структуру FILETIME, содержащую время создания ресурса. Время сообщается в формате UTC. |
| RESOURCE_LASTACCESSTIME | AdFileTime | Только для чтения. Указывает структуру FILETIME, содержащую время последнего доступа к ресурсу. Время в формате UTC. Члены FILETIME равны нулю, если поставщик не поддерживает этот элемент времени. |
| RESOURCE_LASTWRITETIME | AdFileTime | Только для чтения. Указывает структуру FILETIME, содержащую время последней записи ресурса. Время в формате UTC. Члены FILETIME равны нулю, если поставщик не поддерживает этот элемент времени. |
| RESOURCE_STREAMSIZE | какБеззнаковоеБольшоеЧисло | Только для чтения. Указывает размер потока по умолчанию ресурса в байтах. |
| RESOURCE_ISCOLLECTION | AdBoolean | Только для чтения. Значение True, если ресурс является коллекцией, например каталогом. Равно ложь, если ресурс является простым файлом. |
| РЕСУРС_СТРУКТУРИРОВАННЫЙ_ДОКУМЕНТ | AdBoolean | Результат истинно, если ресурс является структурированным документом. Значение false, если ресурс не является структурированным документом. Это может быть коллекция или простой файл. |
| ДОКУМЕНТ_ПО_УМОЛЧАНИЮ | AdVarWChar | Только для чтения. Указывает, что этот ресурс содержит URL-адрес простого документа по умолчанию папки или структурированного документа. Используется при запросе потока по умолчанию из ресурса. Это свойство пусто для простого файла. |
| РАЗДЕЛЕННЫЕ_ДЕТИ | AdChapter | Только для чтения. Необязательный. Указывает главу набора строк, в которой содержатся дочерние элементы ресурса. (Поставщик OLE DB для публикации в Интернете не использует этот столбец.) |
| RESOURCE_DISPLAYNAME | AdVarWChar | Только для чтения. Указывает отображаемое имя ресурса. |
| RESOURCE_ISROOT | AdBoolean | Только для чтения. Истинно, если ресурс является корнем коллекции или структурированного документа. |