Registros y campos de Provider-Supplied
Cuando se abre un objeto Record , su origen puede ser la fila actual de un objeto Recordset abierto, una dirección URL absoluta o una dirección URL relativa en conjunción con un objeto Connection abierto.
Si el Record de se abre desde un Recordset, el objeto RecordFields colección contendrá todos los campos del 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 Record. Como resultado, un Registro puede tener campos únicos que no están en el Conjunto de Registros como un todo o en cualquier Registro derivado de otra fila del Conjunto de Registros.
Por ejemplo, todas las filas de un objeto Recordset de derivadas de un origen de datos de correo electrónico podrían tener columnas como From, To y Subject. Un record de derivado de ese Recordset tendrá los mismos campos. Sin embargo, el record de también puede tener otros campos únicos para el mensaje en particular representado por ese Record, como Attachment y Cc (carbon copy).
Aunque el objeto Record y la fila actual del objeto Recordset tienen los mismos campos, son diferentes porque los objetos Record y Recordset tienen diferentes métodos y propiedades.
Un campo compartido por Record y Recordset se puede modificar en ambos objetos. Sin embargo, el campo no se puede eliminar en el objeto Registro, aunque el proveedor subyacente puede permitir establecer el campo como nulo.
Después de abrir el registro , 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 Record dependen del proveedor subyacente. Actualmente, la mayoría de los proveedores agregan un conjunto de campos que describen la entidad representada por el Record. Si la entidad consta de un flujo de bytes, como un archivo simple, un objeto Stream normalmente se puede abrir desde el Record.
Campos especiales para proveedores de orígenes de documentos
Una clase especial de proveedores, denominada proveedores de origen de documentos, administra carpetas y documentos. Cuando un objeto Record representa un documento o un objeto Recordset de representa una carpeta de documentos, el proveedor de origen del documento rellena esos 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 flujo que representa el documento.
Estos campos constituyen un registro de recurso 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 de campos Fields de un recurso Record o Recordset para recuperar un par de campos comúnmente utilizados. El objeto Field propiedad Value devuelve el contenido deseado.
El campo al que se tiene acceso con la constante adDefaultStream contiene una secuencia predeterminada asociada al objeto Record o Recordset. El proveedor asigna una secuencia predeterminada a un objeto .
El campo al que se accede con el adRecordURL constante contiene la dirección URL absoluta que identifica el documento.
Un proveedor de origen de documentos no admite la colección de objetos Propiedades de Registro y Campo. El contenido de la colección Properties es null para tales 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 del conjunto de registros de recursos
Un conjunto de registros de recursos consta de las columnas siguientes.
| Nombre de 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 | Verdadero 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 donde RESOURCE_ISHIDDEN es True. |
| RECURSO_SOLO_LECTURA | AdBoolean | Verdadero 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 para su lectura. |
| TIPO_DE_CONTENIDO_RECURSO | AdVarWChar | Indica el uso probable del documento, por ejemplo, el breve 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. |
| TIEMPO_CREACIÓN_RECURSO | adFileTime | Solo lectura. Indica una estructura FILETIME que contiene la hora en que se creó el recurso. La hora se notifica en formato hora universal coordinada (UTC). |
| RECURSO_ULTIMOACCESO | AdFileTime | Solo lectura. Indica una estructura FILETIME que contiene la hora a la que se accedió por última vez al recurso. La hora está en formato UTC. Los valores de FILETIME son cero si el proveedor no admite este elemento temporal. |
| RECURSO_ÚLTIMA_FECHA_MODIFICACIÓN | AdFileTime | Solo lectura. Indica una estructura FILETIME que contiene la hora en que se escribió por última vez el recurso. La hora está en formato UTC. Los miembros FILETIME son cero si el proveedor no admite este miembro de tiempo. |
| RESOURCE_STREAMSIZE | comoEnteroGrandeSinSigno | Solo lectura. Indica el tamaño de la secuencia predeterminada del recurso, en bytes. |
| RECURSO_ESCOLECCIÓN | AdBoolean | Solo lectura. True si el recurso es una colección, como un directorio. False si el recurso es un archivo simple. |
| RECURSO_ESESTRUCTURADOCUMENTO | AdBoolean | Verdadero 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. |
| DOCUMENTO_POR_DEFECTO | AdVarWChar | Solo lectura. Indica que este recurso contiene una dirección URL al 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. |
| NIÑOS_CAPITULADOS | AdChapter | Solo lectura. Opcional. Indica el capítulo del conjunto de filas que contiene los subrecursos del recurso. (El proveedor OLE DB para la publicación en Internet no usa esta columna). |
| RESOURCE_DISPLAYNAME | AdVarWChar | Solo lectura. Indica el nombre del recurso para mostrar. |
| RESOURCE_ISROOT | AdBoolean | Solo lectura. True si el recurso es la raíz de una colección o un documento estructurado. |