Registros y campos proporcionados por el proveedor
Cuando un objeto Record está abierto, su origen puede ser la fila actual de un objeto Recordset abierto, una dirección URL absoluta o una dirección URL relativa junto con un objeto Connection abierto.
Si el objeto Record se abre desde un objeto Recordset, la colección Fields del objeto Record contendrá todos los campos del objeto Recordset, además de los campos agregados por el proveedor subyacente.
El proveedor puede insertar campos adicionales que actúen como características complementarias del objeto Record. Como resultado, un objeto Record puede tener campos únicos que no están en el objeto Recordset como un todo o cualquier objeto Record derivado de otra fila del objeto Recordset.
Por ejemplo, todas las filas de un objeto Recordset derivado de un origen de datos de correo electrónico pueden tener columnas como From, To y Subject. Un elemento Record derivado de ese objeto Recordset tendrá los mismos campos. Sin embargo, el elemento Record también puede tener otros campos únicos para el mensaje determinado representado por ese Record, como datos adjuntos y Cc (copia de carbono).
Aunque el objeto Record y la fila actual del objeto Recordset tienen los mismos campos, son diferentes porque los objetos Record y Recordset tienen métodos y propiedades diferentes.
Un campo común a los objetos Record y Recordset se puede modificar en cualquier objeto. Sin embargo, el campo no se puede eliminar en el objeto Record, aunque el proveedor subyacente puede admitir la configuración del campo en NULL.
Una vez abierto el objeto Record, puede agregar campos mediante programación. También puede eliminar los campos que ha agregado, pero no puede eliminar campos del objeto Recordset original.
También puede abrir el objeto Record directamente desde una dirección URL. En este caso, los campos agregados al objeto Record dependen del proveedor subyacente. Actualmente, la mayoría de los proveedores agregan un conjunto de campos que describen la entidad representada por Record. Si la entidad consta de un flujo de bytes, como un archivo simple, normalmente se puede abrir un objeto Stream desde el objeto Record.
Campos especiales para proveedores de orígenes de documentos
Una clase especial de proveedores, denominados proveedores de origen de documentos, administra carpetas y documentos. Cuando un objeto Record representa un documento o un objeto Recordset representa una carpeta de documentos, el proveedor de origen del documento rellena dichos objetos con un conjunto único de campos que describen las características del documento, en lugar del propio documento. Normalmente, un campo contiene una referencia al objeto Stream que representa el documento.
Estos campos constituyen un registro de recursos o un conjunto de registros y se enumeran para los proveedores específicos que los admiten en el Apéndice A: Proveedores.
Dos constantes indexan la colección Fields de los objetos Record o Recordset de un recurso para recuperar un par de campos usados habitualmente. La propiedad Value del objeto Field devuelve el contenido deseado.
El campo al que se accede con la constante adDefaultStream contiene un flujo predeterminado asociado al objeto Record o Recordset. El proveedor asigna un flujo predeterminado a un objeto.
El campo al que se accede con la constante adRecordURL contiene la dirección URL absoluta que identifica el documento.
Un proveedor de origen de documentos no admite la colección Properties de objetos Record y Field. El contenido de la colección Properties es null para dichos objetos.
Un proveedor de origen de documentos puede agregar una propiedad específica del proveedor, como Tipo de origen de datos, para identificar si es un proveedor de origen de documentos. Para obtener más información sobre cómo determinar el tipo de proveedor, consulte la documentación del proveedor.
Columnas de Recordset de recursos
Un conjunto de registros de recursos consta de las columnas siguientes.
| Nombre de la columna | Tipo | Descripción |
|---|---|---|
| RESOURCE_PARSENAME | AdVarWChar | Solo lectura. Indica la dirección URL del recurso. |
| RESOURCE_PARENTNAME | AdVarWChar | Solo lectura. Indica la dirección URL absoluta del registro primario. |
| RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | Solo lectura. Indica la dirección URL absoluta del recurso, que es la concatenación de PARENTNAME y PARSENAME. |
| RESOURCE_ISHIDDEN | AdBoolean | True si el recurso está oculto. No se devolverá ninguna fila a menos que el comando que crea el conjunto de filas seleccione explícitamente las filas en las que RESOURCE_ISHIDDEN es True. |
| RESOURCE_ISREADONLY | AdBoolean | Es true si el recurso es de solo lectura. Intenta abrir este recurso con DBBINDFLAG_WRITE y producirá un error con DB_E_READONLY. Esta propiedad se puede editar incluso cuando el recurso solo se ha abierto en modo de lectura. |
| RESOURCE_CONTENTTYPE | AdVarWChar | Indica el uso probable del documento, por ejemplo, el sumario de un abogado. Esto puede corresponder a la plantilla de Office que se usó para crear el documento. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Indica el tipo MIME del documento, que indica el formato como "text/html". |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Indica el idioma en el que se almacena el contenido. |
| RESOURCE_CREATIONTIME | adFileTime | Solo lectura. Indica una estructura FILETIME que contiene la hora en que se creó el recurso. La hora se representa en formato de hora universal coordinada (UTC). |
| RESOURCE_LASTACCESSTIME | AdFileTime | Solo lectura. Indica una estructura FILETIME que contiene la última hora de acceso al recurso. La hora presenta el formato UTC. Los miembros FILETIME son cero si el proveedor no admite este miembro de hora. |
| RESOURCE_LASTWRITETIME | AdFileTime | Solo lectura. Indica una estructura FILETIME que contiene la hora en que se escribió por última vez en el recurso. La hora presenta el formato UTC. Los miembros FILETIME son cero si el proveedor no admite este miembro de hora. |
| RESOURCE_STREAMSIZE | asUnsignedBigInt | Solo lectura. Indica el tamaño de la secuencia predeterminada del recurso, en bytes. |
| RESOURCE_ISCOLLECTION | AdBoolean | Solo lectura. True si el recurso es una colección, como un directorio. False si el recurso es un archivo simple. |
| RESOURCE_ISSTRUCTUREDDOCUMENT | AdBoolean | True si el recurso es un documento estructurado. False si el recurso no es un documento estructurado. Podría ser una colección o un archivo simple. |
| DEFAULT_DOCUMENT | AdVarWChar | Solo lectura. Indica que este recurso contiene una dirección URL para el documento simple predeterminado de una carpeta o un documento estructurado. Se usa cuando se solicita la secuencia predeterminada desde un recurso. Esta propiedad está en blanco para un archivo simple. |
| CHAPTERED_CHILDREN | AdChapter | Solo lectura. Opcional. Indica el capítulo del conjunto de filas que contiene los elementos secundarios del recurso. (El proveedor OLE DB para la publicación en Internet no usa esta columna). |
| RESOURCE_DISPLAYNAME | AdVarWChar | Solo lectura. Indica el nombre para mostrar del recurso. |
| RESOURCE_ISROOT | AdBoolean | Solo lectura. True si el recurso es la raíz de una colección o un documento estructurado. |