Objeto Record (ADO)

  • Artículo

Representa una fila de un objeto Recordset o del proveedor de datos, o un objeto devuelto por un proveedor de datos semiestructurado, como un archivo o directorio.

Comentarios

Un objeto Record representa una fila de datos y tiene algunas similitudes conceptuales con un objeto Recordset de una fila. Dependiendo de las funcionalidades del proveedor, los objetos Record se pueden devolver directamente desde el proveedor en lugar de un objeto Recordset de una fila, por ejemplo, cuando se ejecuta una consulta SQL que selecciona solo una fila. O bien, se puede obtener un objeto Record directamente de un objeto Recordset. También se puede devolver un Record directamente desde un proveedor a datos semiestructurados, como el proveedor OLE DB de Microsoft Exchange.

Puede ver los campos asociados al objeto Record mediante la colección Fields en el objeto Record. ADO permite columnas con valores de objeto, incluidos Recordset, SafeArray y valores escalares en la colección Fields de objetos Record.

Si el objeto Record representa una fila de un objeto Recordset, es posible volver a ese objeto Recordset original con la propiedad Source.

Los proveedores de datos semiestructurados también pueden usar el objeto Record, como el proveedor OLE DB de Microsoft para publicación en Internet, para modelar espacios de nombres estructurados en árboles. Cada nodo del árbol es un objeto Record con columnas asociadas. Las columnas pueden representar los atributos de ese nodo y otra información relevante. El objeto Record puede representar un nodo hoja y un nodo no hoja en la estructura de árbol. Los nodos no hoja contienen otros nodos, pero los nodos hoja no tienen dicho contenido. Normalmente, los nodos hoja contienen flujos binarios de datos y los nodos no hoja también pueden tener asociada una secuencia binaria predeterminada. Las propiedades del objeto Record identifican el tipo de nodo.

El objeto Record también representa una forma alternativa de navegar por los datos organizados jerárquicamente. Se puede crear un objeto Record para representar la raíz de un subárbol específico en una estructura de árbol grande y se pueden abrir nuevos objetos Record para representar nodos secundarios.

Un recurso (por ejemplo, un archivo o directorio) se puede identificar de forma única mediante una dirección URL absoluta. Un objeto Connection se crea implícitamente y se establece en el objeto Record cuando el objeto Record se abre mediante una URL absoluta. Un objeto Connection se puede establecer explícitamente en el objeto Record a través de la propiedad ActiveConnection. Los archivos y directorios a los que se puede tener acceso mediante el objeto Connection definen el contexto en el que pueden producirse las operaciones Record.

Los métodos de modificación y navegación de datos del objeto Record también aceptan una URL relativa, que localiza un recurso mediante una URL absoluta o el contexto del objeto Connection como punto de partida.

Nota:

Las URL que usan el esquema http invocan automáticamente el Proveedor de Microsoft OLE DB para publicaciones en Internet. Para obtener más información, vea Direcciones URL absolutas y relativas.

A cada objeto Record se le asocia un objetoConnection. Por lo tanto, las operaciones de objeto Record pueden formar parte de una transacción invocando métodos de transacción del objeto Connection.

El objeto Record no admite eventos de ADO y, por lo tanto, no responde a las notificaciones.

Con los métodos y propiedades de un objeto Record, se puede hacer lo siguiente:

  • Establecer o devolver el objeto Connection asociado con la propiedad ActiveConnection.

  • Indicar los permisos de acceso con la propiedad Mode.

  • Devolver, si existe, la dirección URL del directorio que contiene el recurso que el Record representa con la propiedad ParentURL.

  • Indicar la URL absoluta, la URL relativa o el objeto Recordset del que se deriva el objeto Record con la propiedad Source.

  • Indicar el estado actual del objeto Record con la propiedad State.

  • Indique el tipo de Registro - simple, colección o documento estructurado, con la propiedad RecordType.

  • Detener la ejecución de una operación asincrónica con el método Cancel.

  • Desasociar el objeto Record de un origen de datos con el método Close.

  • Copiar el archivo o directorio representado por un objeto Record en otra ubicación con el método CopyRecord.

  • Eliminar el archivo, o directorio y subdirectorios, representados por un objeto Record con el método DeleteRecord.

  • Abrir un objeto Recordset que contiene filas que representan los subdirectorios y archivos de la entidad representada por el objeto Record con el método GetChildren.

  • Mover (renombrar) el archivo, o directorio y subdirectorios, representados por un objeto Record a otra ubicación con el método MoveRecord.

  • Asociar el objeto Record a un origen de datos existente o crear un nuevo archivo o directorio con el método Open.

El objeto Record permite crear scripts de forma segura.

Esta sección contiene el tema siguiente.

Consulte también

Fields (colección) (ADO)
Colección de propiedades (ADO)
Registros y secuencias
Objeto de conjunto de registros (ADO)