Propiedad ActiveConnection (ADO)

Se aplica a: Access 2013, Office 2013

Indica a qué objeto Connection pertenece actualmente el objeto Command, Recordset o Record especificado.

Configuración y valores devueltos

Establece o devuelve un valor de tipo String que contiene la definición de una conexión si la conexión está cerrada, o bien, Variant que contiene el actual objeto Connection si la conexión está abierta. El valor predeterminado es una referencia de objeto nula. Vea la propiedad ConnectionString.

Comentarios

Use la propiedad ActiveConnection para determinar el objeto Connection a través del cual se va a ejecutar el objeto Command especificado o se va a abrir el objeto Recordset especificado.

Get-Help

Para los objetos Command, la propiedad ActiveConnection es de lectura y de escritura.

Si se intenta llamar al método Execute en un objeto Command antes de que se establezca esta propiedad en un objeto Connection abierto o una cadena de conexión válida, se produce un error.

Microsoft Visual Basic: al establecer la propiedad ActiveConnection en Nothing , se desasocia el objeto Command de la conexión actual y hace que el proveedor libere los recursos asociados en el origen de datos. A continuación, se puede asociar el objeto Command al mismo objeto Connection o a otro. Algunos proveedores permiten cambiar la configuración de la propiedad de un objeto Connection a otro, sin tener que establecer primero la propiedad en Nothing.

Si la colección Parameters del objeto Command contiene parámetros proporcionados por el proveedor, se borra la colección si se establece la propiedad ActiveConnection en Nothing u otro objeto Connection. Si se crean objetos Parameter manualmente y se utilizan para rellenar la colección Parameters del objeto Command, al establecer la propiedad ActiveConnection en Nothing u otro objeto Connection, la colección Parameters se mantiene intacta.

Al cerrar el objeto Connection al que está asociado un objeto Command, el valor de la propiedad ActiveConnection se establece en Nothing. Si se establece esta propiedad en un objeto Connection cerrado, se genera un error.

Recordset

Para los objetos Recordset abiertos u objetos Recordset cuya propiedad Source está establecida en un objeto Command válido, la propiedad ActiveConnection es de sólo lectura. En caso contrario, es de lectura y escritura.

Esta propiedad se puede establecer en un objeto Connection válido o en una cadena de conexión válida. En este caso, el proveedor crea un nuevo objeto Connection mediante esta definición y abre la conexión. Además, el proveedor puede establecer esta propiedad en el nuevo objeto Connection para permitir al usuario obtener acceso al objeto Connection con el fin de obtener amplia información de errores o ejecutar otros comandos.

Si se usa el argumento ActiveConnection del método Open para abrir un objeto Recordset, la propiedad ActiveConnection heredará el valor del argumento.

Si se establece la propiedad Source del objeto Recordset en una variable del objeto Command, la propiedad ActiveConnection del objeto Recordset hereda el valor de la propiedad ActiveConnection del objeto Command.

Uso del servicio de datos remotos: cuando se usa en un objeto Recordset del lado cliente, esta propiedad solo se puede establecer en un cadena de conexión o (en Microsoft Visual Basic o Visual Basic, Scripting Edition) en Nothing.

Record

Esta propiedad es de lectura y escritura cuando el objeto Record está cerrado, y puede contener una cadena de conexión o una referencia a un objeto Connection abierto. Esta propiedad es de sólo lectura cuando el objeto Record está abierto, y contiene una referencia a un objeto Connection abierto.

Se crea implícitamente un objeto Connection cuando se abre el objeto Record desde una dirección URL. Abra el objeto Record con un objeto Connection existente abierto asignando el objeto Connection a esta propiedad o utilizando el objeto Connection como parámetro en la llamada al método Open. Si el objeto Record se abre desde un objeto Record o Recordset existente, se asocia automáticamente al objeto Connection de ese objeto Record o Recordset.

Nota:

[!NOTA] Las direcciones URL que utilizan el esquema http llamarán automáticamente a Microsoft OLE DB Provider for Internet Publishing. Para obtener más información, consulte Direcciones URL absolutas y relativas.