Objeto Connection (ADO)

Se aplica a: Access 2013, Office 2013

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

Comentarios

Un objeto Connection representa una sesión única con un origen de datos. En el caso de un sistema de base de datos cliente/servidor, puede ser equivalente a una conexión de red real con el servidor. Según sea la funcionalidad admitida por el proveedor, algunas colecciones, métodos o propiedades de un objeto Connection podrían no estar disponibles.

Con las colecciones, los métodos y las propiedades de un objeto Connection, se 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 llamar al 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 para las transacciones abiertas en la conexión con la propiedad IsolationLevel.

• Especificar un proveedor OLE DB con la propiedad Provider.

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

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

  Nota:

  [!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 se desea conservar el texto del comando y volver a ejecutarlo, o usar parámetros de consulta.

• Administrar 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 utilizada con la propiedad Version.

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

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

Puede ejecutar comandos o procedimientos almacenados como si fueran métodos nativos en el objeto Connection, como se ilustra más adelante.

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

Para ejecutar un comando, asígnele un nombre 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 en la que se use el nombre del comando como si fuera un método en el objeto Connection, seguido de los parámetros que desee, y seguido después de 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.yourCommandName "parameter", rst

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

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

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