ActiveConnection (propiedad, ADO)

Artículo
05/30/2023

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, un valor 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

En los objetos Command, la propiedad ActiveConnection es de lectura y 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 en una cadena de conexión válida, se produce un error.

Si se asigna un objeto Connection a la propiedad ActiveConnection, se debe abrir el objeto. Si se asigna un objeto Connection cerrado, se produce un error.

Nota

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 establece la propiedad ActiveConnection en Nothing o en otro objeto Connection. Si se crean objetos Parameter manualmente y se usan para rellenar la colección Parameters del objeto Command, al establecer la propiedad ActiveConnection en Nothing u otro objeto Connection, la colección Parameters permanece 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 produce un error.

Recordset

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

Esta propiedad se puede establecer en un objeto Connectionvá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 establece la propiedad Source del objeto Recordset en una variable válida del objeto Command, la propiedad ActiveConnection del objeto Recordset hereda el valor de la propiedad ActiveConnection del objeto Command.

Nota

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

Registro

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 solo lectura cuando el objeto Record está abierto y contiene una referencia a un objeto Connection abierto.

Se crea implícitamente un objeto Connection cuando el objeto Record se abre desde una dirección URL. Abra el objeto Record con un objeto Connection existente abierto; para ello, asigne el objeto Connection a esta propiedad o use 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 con el objeto Connection de ese objeto Record o Recordset.