Objeto Record (ADO)

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.

Observaciones

Un objeto Record representa una fila de datos y tiene algunas similitudes conceptuales con un objeto Recordset de una fila. En función 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, un objeto Record se puede obtener directamente desde un objeto Recordset . O bien, se puede devolver un registro 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 internet Publishing, 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 que no son hoja tienen otros nodos como su contenido, pero los nodos hoja no tienen ese contenido. Normalmente, los nodos hoja contienen flujos binarios de datos y 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 manera alternativa de navegar por 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 dirección 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 acceder mediante el objeto Connection definen el contexto en el que pueden producirse operaciones de registro .

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

Un objeto Connection está asociado a cada objeto Record . 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 tanto, no responderá a las notificaciones.

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

• Establezca o devuelva el objeto Connection asociado con la propiedad ActiveConnection .

• Indique los permisos de acceso con la propiedad Mode .

• Devuelve la dirección URL del directorio, si existe, que contiene el recurso representado por el registro con la propiedad ParentURL .

• Indique la dirección URL absoluta, la dirección URL relativa o el objeto Recordset desde el que se deriva el registro con la propiedad Source .

• Indique 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 .

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

• Desasocie el registro de un origen de datos con el método Close .

• Copie el archivo o directorio representado por un registro en otra ubicación con el método CopyRecord .

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

• Abra un objeto Recordset que contenga filas que representen los subdirectorios y archivos de la entidad representada por el objeto Record con el método GetChildren .

• Mueva (cambie el nombre) el archivo, o directorio y subdirectorios, representados por un registro a otra ubicación con el método MoveRecord .

• Asocie el registro a un origen de datos existente o cree un nuevo archivo o directorio con el método Open .

El objeto Record es seguro para el scripting.

Esta sección contiene el tema siguiente.

• Propiedades, métodos y eventos de objeto de registro

Véase también

colección fields (ADO)
Colección de Propiedades (ADO)
Registros de datos y flujos de datos
objeto Recordset (ADO)