Método Close (ADO)

Cierra un objeto abierto y los objetos dependientes.

Sintaxis

  
object.Close  

Observaciones

Utilice el método Close para cerrar una conexión, un objeto Record, un objeto Recordset o Stream para liberar los recursos del sistema asociados. Cerrar un objeto no lo quita de la memoria; Puede cambiar su configuración de propiedad y abrirla de nuevo más tarde. Para eliminar completamente un objeto de la memoria, cierre el objeto 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 persistirá, pero ya no se asociará con un objeto Connection ; es decir, su propiedad ActiveConnection se establecerá en Nothing. Además, la colección Parameters del objeto Command se borrará de 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. Mientras se cierra el objeto Connection , llamar a cualquier método que requiera una conexión abierta al origen de datos 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 queda fuera del ámbito mientras una transacción está en curso, ADO revierte automáticamente la transacción.

Conjunto de registros, registro, secuencia

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 modificados.

Mientras se cierra un objeto Recordset , llamar a los métodos que requieren 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 genera 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 Recordset (ADO)
objeto Stream (ADO)

Véase también

Ejemplo de métodos Open y Close (VB)
Ejemplo de métodos Open y Close (VBScript)
Ejemplo de métodos Open y Close (VC++)
Open (conexión ADO)
Método Open (Recordset de ADO)
Método Guardar