Objeto de conexión (ADO)

Representa una conexión abierta a un origen de datos.

Comentarios

Un objeto Connection representa una sesión única con un origen de datos. En un sistema de base de datos cliente/servidor, puede ser equivalente a una conexión de red real con el servidor. Según la funcionalidad que admita el proveedor, es posible que algunas colecciones, métodos o propiedades de un objeto Connection no estén disponibles.

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

• Configurar la conexión antes de abrirla con las propiedades ConnectionString, ConnectionTimeout y Mode. ConnectionString es la propiedad predeterminada del objeto Connection.

• Establecer la propiedad CursorLocation en el cliente para invocar el Servicio de cursores de Microsoft para OLE DB, que admite actualizaciones por lotes.

• Establecer la base de datos predeterminada para la conexión con la propiedad DefaultDatabase.

• Establecer el nivel de aislamiento de las transacciones abiertas en la conexión con la propiedad IsolationLevel.

• Especificar un proveedor OLE DB con la propiedad Provider.

• Establecer e interrumpir posteriormente la conexión física al origen de datos con los métodos Open y Close.

• Ejecutar un comando en la conexión con el método Execute y configure la ejecución con la propiedad CommandTimeout.

  Nota:

  Para ejecutar una consulta sin usar un objeto Command, pase una cadena de consulta al método Execute de un objeto Connection. Sin embargo, se requiere un objeto Command cuando desea conservar el texto del comando y volver a ejecutarlo, o bien usar parámetros de consulta.

• Administrar las transacciones en la conexión abierta, incluidas las transacciones anidadas si el proveedor las admite, con los métodos BeginTrans, CommitTrans y RollbackTrans y la propiedad Attributes.

• Examinar los errores devueltos desde el origen de datos con la colección Errors.

• Leer la versión de la implementación de ADO usada con la propiedad Version.

• Obtener información de esquema sobre la base de datos con el método OpenSchema.

Puede crear objetos Connection independientemente de cualquier otro objeto definido previamente.

Puede ejecutar comandos con nombre o procedimientos almacenados como si fueran métodos nativos en un objeto Connection, como se muestra en la sección siguiente. Cuando un comando con nombre tiene el mismo nombre que el de un procedimiento almacenado, invoque la "llamada de método nativo" en un objeto Connection y ejecute siempre el comando con nombre en lugar del procedimiento almacenado.

Nota:

No use esta característica (llamando a un comando con nombre o procedimiento almacenado como si fuera un método nativo en el objeto Conectar ion) en una aplicación de Microsoft .NET Framework, porque la implementación subyacente de la característica entra en conflicto con la forma en que .NET Framework interopera con COM.

Ejecución de un comando como método nativo de un 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 en la conexión. A continuación, emita una instrucción donde se use el nombre del comando como si fuera un método en el objeto Connection, seguido de cualquier parámetro, y un objeto Recordset si se devuelven filas. Establezca las propiedades Recordset para personalizar el objeto Recordset resultante. Por ejemplo:

Dim cnn As New ADODB.Connection  
Dim cmd As New ADODB.Command  
Dim rst As New ADODB.Recordset  
...  
cnn.Open "..."  
cmd.Name = "yourCommandName"  
cmd.ActiveConnection = cnn  
...  
'Your command name, any parameters, and an optional Recordset.  
cnn. "parameter", rst  

Ejecución de un procedimiento almacenado como un método nativo de un objeto Connection

Para ejecutar un procedimiento almacenado, emita una instrucción donde se use el nombre del procedimiento almacenado como si fuera un método en el objeto Connection, seguido de cualquier parámetro. ADO realizará la "mejor estimación" de los tipos de parámetros. Por ejemplo:

Dim cnn As New ADODB.Connection  
...  
'Your stored procedure name and any parameters.  
cnn. "parameter"  

El objeto Connection es seguro para el scripting.

Esta sección contiene el tema siguiente.

• Eventos, métodos y propiedades del objeto Connection

Consulte también

Objeto Command (ADO)
Colección de errores (ADO)
Colección de propiedades (ADO)
Objeto de conjunto de registros (ADO)
Apéndice A: Proveedores