Compartir a través de


Registros y campos proporcionados por el proveedor

Se aplica a: Access 2013, Office 2013

Cuando se abre un objeto Record, su origen puede ser la actual fila 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 de Recordset, además de los campos agregados por el proveedor subyacente.

El proveedor puede insertar campos adicionales que sirven de características complementarias del objeto Record. Como resultado, un objeto Record puede tener campos únicos no incluidos en el objeto Recordset como conjunto o cualquier objeto Record derivado de otra fila del objeto Recordset.

Por ejemplo, todas las filas de un objeto Recordset derivadas de un origen de datos de correo electrónico pueden tener columnas como From, To y Subject. Un objeto Record derivado de ese objeto Recordset tendrá los mismos campos. Sin embargo, el objeto Record también puede tener otros campos únicos para el mensaje concreto representado por ese Record, como Datos adjuntos y CC (Con copia).

Si bien el objeto Record y la actual fila del objeto Recordset tienen los mismos campos, son diferentes porque los objetos Record y Recordset tienen métodos y propiedades distintos.

Un campo que tienen en común Record y Recordset puede modificarse en cualquiera de los objetos. Sin embargo, el campo no se puede eliminar en el objeto Record, aunque el proveedor subyacente permita establecer el campo en null.

Tras abrir el objeto Record, puede agregar campos mediante programación. También puede eliminar los campos que agregó, pero no puede eliminar campos del objeto Recordset original.

Asimismo, 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 el objeto Record. Si la entidad consta de una secuencia 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 orígenes de documentos, administra las carpetas y los documentos. Cuando un objeto Record representa un documento o un objeto Recordset representa una carpeta de documentos, el proveedor de orígenes de documentos 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 objeto Stream que representa el documento.

Estos campos constituyen un objeto Record o Recordset de recurso y se enumeran para los proveedores específicos que los admiten en Apéndice A: Proveedores.

Dos constantes indican la colección Fields de un objeto Record o Recordset de recurso para recuperar un par de campos de uso común. La propiedad Value del objeto Field devuelve el contenido deseado.

  • El campo al que se obtiene acceso con la constante adDefaultStream contiene una secuencia asociada al objeto Record o Recordset. El proveedor asigna una secuencia predeterminada a un objeto.

  • El campo al que se obtiene acceso con la constante adRecordURL contiene la dirección URL absoluta que identifica el documento.

Un proveedor de orígenes de documentos no admite la colección Properties de los objetos Record y Field. El contenido de la colección Properties es nulo para dichos objetos.

Un proveedor de orígenes de documentos puede agregar una propiedad específica, como Datasource Type, para identificar si es un proveedor de orígenes de documentos. Para obtener más información sobre cómo determinar el tipo de proveedor, vea la documentación de su proveedor.

Columnas de conjuntos de registros de recurso

Un conjunto de registros de recurso 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

Es 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 filas donde el valor de RESOURCE_ISHIDDEN es True.

RESOURCE_ISREADONLY

AdBoolean

Es True si el recurso es de sólo lectura. Al intentar abrir este recurso con DBBINDFLAG_WRITE, se generará un error con DB_E_READONLY. Esta propiedad se puede modificar, incluso si el recurso se ha abierto sólo para leerlo.

RESOURCE_CONTENTTYPE

AdVarWChar

Indica el uso probable del documento; por ejemplo, un expediente de abogado. Puede corresponder a la plantilla de Office utilizada 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 de creación del recurso. El tiempo se indica en formato UTC (Horario universal coordinado).

RESOURCE_LASTACCESSTIME

AdFileTime

Solo lectura. Indica una estructura FILETIME que contiene la hora del último acceso al recurso. La hora está en formato UTC. Los miembros de 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 a la que se escribió el recurso por última vez. La hora se especifica en formato UTC. Los miembros de FILETIME son cero si el proveedor no admite este miembro de hora.

RESOURCE_STREAMSIZE

asUnsignedBigInt

Solo lectura. Indica el tamaño, en bytes, de la secuencia predeterminada del recurso.

RESOURCE_ISCOLLECTION

AdBoolean

Solo lectura. Es True si el recurso es una colección, como un directorio. Es False si el recurso es un archivo simple.

RESOURCE_ISSTRUCTUREDDOCUMENT

AdBoolean

Es True si el recurso es un documento estructurado. Es 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 al documento simple predeterminado de una carpeta o un documento estructurado. Se utiliza cuando se solicita la secuencia predeterminada de un recurso. Esta propiedad está en blanco en el caso de un archivo simple.

CHAPTERED_CHILDREN

AdChapter

Solo lectura. Opcional. Indica el capítulo del conjunto de filas que contiene los objetos secundarios del recurso. (OLE DB Provider for Internet Publishing no utiliza esta columna.)

RESOURCE_DISPLAYNAME

AdVarWChar

Solo lectura. Indica el nombre para mostrar del recurso.

RESOURCE_ISROOT

AdBoolean

Solo lectura. Es True si el recurso es la raíz de una colección o un documento estructurado.