Close (método) (ADO)

Cierra un objeto abierto y los objetos dependientes.

Sintaxis

  
object.Close  

Comentarios

Use el método Close para cerrar un objeto Connection, Record, Recordset o Stream para liberar los recursos del sistema asociados. Al cerrar un objeto, este no se elimina de la memoria; es decir, puede cambiar la configuración de sus propiedades y abrirlo de nuevo más tarde. Para eliminar completamente un objeto de la memoria, ciérrelo y, a continuación, establezca la variable de objeto en Nothing (en Visual Basic).

Conexión

El uso del método Close para cerrar un objeto Connection también cierra los objetos Recordset activos asociados a la conexión. Un objeto Command asociado al objeto Connection que está cerrando se conservará, pero dejará de estar asociado a un objeto Connection; es decir, su propiedad ActiveConnection se establecerá en Nothing. Además, la colección Parameters del objeto Command se borrará de todos los parámetros definidos por el proveedor.

Más adelante puede llamar al método Open para volver a establecer la conexión con el mismo origen de datos u otro distinto. Mientras se cierra el objeto Connection, al llamar a los métodos que requieren una conexión abierta al origen de datos se genera un error.

Cerrar un objeto Connection mientras hay objetos Recordset abiertos en la conexión revierte los cambios pendientes en todos los objetos Recordset. Cerrar explícitamente un objeto Connection (llamando al método Close) mientras una transacción está en curso genera un error. Si un objeto Connection está fuera del ámbito mientras una transacción está en curso, ADO revierte automáticamente la transacción.

Recordset, Record y Stream

El uso del método Close para cerrar un objeto Recordset, Record o Stream libera los datos asociados y cualquier acceso exclusivo que haya tenido a los datos a través de este objeto determinado. Más adelante puede llamar al método Open para volver a abrir el objeto con los mismos atributos o con atributos modificados.

Mientras se cierra un objeto Recordset, llamar a cualquier método que requiera un cursor activo genera un error.

Si una edición está en curso mientras está en modo de actualización inmediata, llamar al método Close generará un error; en su lugar, llame primero al método Update o CancelUpdate. Si cierra el objeto Recordset mientras está en modo de actualización por lotes, se pierden todos los cambios desde la última llamada a UpdateBatch.

Si usa el método Clone para crear copias de un objeto Recordset abierto, cerrar el original o un clon no afecta a ninguna de las demás copias.

Se aplica a

Objeto de conexión (ADO)
Objeto Record (ADO)

Objeto de conjunto de registros (ADO)
Objeto de secuencia (ADO)

Consulte también

Ejemplo de los métodos de apertura y cierre (VB)
Ejemplo de los métodos Open y Close (VBScript)
Ejemplo de los métodos Open y Close (VC ++)
Open (método) (conexión de ADO)
Open (método) (conjunto de registros ADO)
Save (método)