Propiedad ActiveConnection (ADO)

2017-01-19

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 una definición para una conexión si la conexión está cerrada o un valor Variant que contiene el objeto Connection actual si la conexión está abierta. El valor predeterminado es una referencia de objeto NULL. Consulte la propiedad ConnectionString .

Observaciones

Utilice la propiedad ActiveConnection para determinar el objeto Connection sobre el que se ejecutará el objeto Command especificado o se abrirá el objeto Recordset especificado.

Comando

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

Si intenta llamar al método Execute en un objeto Command antes de establecer esta propiedad en un objeto Connection abierto o 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 . La asignación de un objeto Connection cerrado 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 se hace que el proveedor libere los recursos asociados en el origen de datos. A continuación, puede asociar el objeto Command con el mismo u otro objeto Connection . Algunos proveedores permiten cambiar el valor de la propiedad de una conexión a otra, sin tener que establecer primero la propiedad en Nothing.

Si la colección Parameters del objeto Command contiene parámetros proporcionados por el proveedor, la colección se borra si establece la propiedad ActiveConnection en Nothing o en otro objeto Connection . Si crea manualmente objetos Parameter y los usa para rellenar la colección Parameters del objeto Command , establecer la propiedad ActiveConnection en Nothing o en otro objeto Connection deja intacta la colección Parameters .

Al cerrar el objeto Connection con el que se asocia un objeto Command , se establece la propiedad ActiveConnection en Nothing. Si se establece esta propiedad en un objeto Connection cerrado, se genera un error.

Conjunto de registros

Para los objetos Recordset abiertos o para los objetos Recordset cuya propiedad Source está establecida en un objeto Command válido, la propiedad ActiveConnection es de solo lectura. De lo contrario, es de lectura y escritura.

Puede establecer esta propiedad 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 proporcionarle una manera de acceder al objeto Connection para obtener información de error extendida o para ejecutar otros comandos.

Si 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 de objeto Command válida, 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 se cierra el objeto Record 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.

Un objeto Connection se crea implícitamente cuando el objeto Record se abre desde una dirección URL. Abra el objeto Record con un objeto Connection existente mediante la asignación del objeto Connection a esta propiedad o el uso del 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 del objeto Record o Recordset.