Compartir a través de

Objeto Connection (ADO)

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

Observaciones

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 al servidor. Según la funcionalidad admitida por el proveedor, es posible que algunas colecciones, métodos o propiedades de un objeto Connection no estén disponibles.

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

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

  • Establezca la propiedad CursorLocation en el cliente para invocar el servicio de cursor de Microsoft para OLE DB, que admite actualizaciones por lotes.

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

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

  • Especifique un proveedor OLE DB con la propiedad Provider .

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

  • Ejecute 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 necesita un objeto Command cuando desee conservar el texto del comando y volver a ejecutarlo, o bien use parámetros de consulta.

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

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

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

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

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

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 al método nativo" en un objeto Connection ejecute siempre el comando con nombre en lugar del procedimiento de almacén.

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 Connection ) 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.

Ejecutar un comando como método nativo de un objeto Connection

Para ejecutar un comando, asigne un nombre al comando mediante la propiedad Nombre del objeto Command. Establezca la propiedad ActiveConnection del objeto Command en la conexión. A continuación, emita una instrucción en la que 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

Ejecutar un procedimiento almacenado como método nativo de un objeto Connection

Para ejecutar un procedimiento almacenado, emita una instrucción en la que se usa el nombre del procedimiento almacenado como si fuera un método en el objeto Connection , seguido de cualquier parámetro. ADO hará una "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.

Véase también

del objeto Command (ADO) de
colección de errores (ADO)
Colección de Propiedades (ADO)
objeto Recordset (ADO)
Apéndice A: Proveedores

  • Last updated on