Referencia Técnica de Objetos ADO: Configuración y Ejecución de Connection y Command

Objeto Connection (ADO): Estableciendo la Conexión con el Origen de Datos

Un objeto Connection representa una conexión abierta y activa con un origen de datos.

Funcionalidad y Comentarios

Un objeto Connection representa una sesión única con un origen de datos. En el contexto de un sistema de base de datos cliente/servidor, este objeto es equivalente a una conexión de red actual con el servidor.

Dependiendo de la funcionalidad que acepte el proveedor (Provider), algunas colecciones, métodos o propiedades de un objeto Connection pueden no estar disponibles.

Mediante las colecciones, métodos y propiedades de un objeto Connection, usted puede realizar las siguientes acciones clave:

• Configuración Inicial: Configurar la conexión antes de abrirla utilizando las propiedades ConnectionString, ConnectionTimeout y Mode.
• Ubicación del Cursor: Establecer la propiedad CursorLocation para invocar al Client Cursor Provider, lo que permite aceptar actualizaciones por lotes.
• Base de Datos Predeterminada: Establecer la base de datos predeterminada para la conexión con la propiedad DefaultDatabase.
• Nivel de Aislamiento: Establecer el nivel de aislamiento de las transacciones abiertas en la conexión con la propiedad IsolationLevel.
• Especificación del Proveedor: Especificar un proveedor de OLE DB con la propiedad Provider.
• Control de Conexión: Establecer, y posteriormente romper, la conexión física con el origen de datos mediante los métodos Open y Close.
• Ejecución de Comandos: Ejecutar un comando directamente en la conexión con el método Execute y configurar el tiempo de espera de la ejecución con la propiedad CommandTimeout.
• Gestión de Transacciones: Administrar transacciones en la conexión abierta, incluyendo transacciones anidadas si el proveedor las soporta, utilizando los métodos BeginTrans, CommitTrans y RollbackTrans, junto con la propiedad Attributes.
• Manejo de Errores: Examinar los errores devueltos por el origen de datos a través de la colección Errors.
• Información de Versión: Leer la versión de la implementación de ADO en uso con la propiedad Version.
• Metadatos del Esquema: Obtener información del esquema de la base de datos con el método OpenSchema.

Ejecución de Comandos a través del Objeto Connection

Para ejecutar un comando, asigne un nombre al comando mediante la propiedad Name del objeto Command. Establezca la propiedad ActiveConnection del objeto Command como la conexión. Después, emita una instrucción donde el nombre del comando se utilice como si fuese un método del objeto Connection, seguido de cualquier parámetro, seguido de un objeto Recordset si se devuelve alguna fila. Recuerde establecer las propiedades del Recordset para personalizar el conjunto de registros resultante.

Objeto Command (ADO): Definición y Ejecución de Instrucciones

Un objeto Command es la definición de una instrucción o comando específico que se ejecutará contra un origen de datos.

Funcionalidad y Comentarios

Utilice un objeto Command para consultar una base de datos y obtener registros en un objeto Recordset, para ejecutar una operación de manejo masivo de datos o para manipular la estructura de una base de datos (DDL).

Dependiendo de la funcionalidad del proveedor, algunas colecciones, métodos o propiedades de Command pueden generar un error cuando se les haga referencia.

Con las colecciones, métodos y propiedades de un objeto Command, usted puede:

• Definición del Texto: Definir el texto ejecutable del comando (por ejemplo, una instrucción SQL) con la propiedad CommandText.
• Parámetros: Definir consultas parametrizadas o argumentos de procedimientos almacenados con los objetos Parameter y la colección Parameters.
• Ejecución: Ejecutar un comando y obtener un objeto Recordset si resulta apropiado con el método Execute.
• Optimización de Tipo: Especificar el tipo de comando con la propiedad CommandType antes de la ejecución para optimizar el rendimiento.
• Comando Preparado: Controlar si el proveedor guarda una versión preparada (o compilada) del comando antes de la ejecución, con la propiedad Prepared.
• Tiempo de Espera: Establecer el número de segundos que un proveedor esperará que el comando se ejecute con la propiedad CommandTimeout.
• Asociación de Conexión: Asociar una conexión abierta con un objeto Command estableciendo su propiedad ActiveConnection.
• Identificación: Establecer la propiedad Name para identificar el objeto Command como un método del objeto Connection asociado.
• Fuente de Datos: Pasar un objeto Command a la propiedad Source de un Recordset para obtener los datos.

Invocación del Objeto Command

Para ejecutar un Command, solo invóquelo utilizando su propiedad Name en el objeto Connection asociado. El objeto Command tiene que tener su propiedad ActiveConnection establecida al objeto Connection. Si el objeto Command tuviera parámetros, pase los valores de los parámetros como argumentos del método de invocación.