Condividi tramite


Metodo Close (ADO)

Chiude un oggetto aperto e tutti gli oggetti dipendenti.

Sintassi

  
object.Close  

Osservazioni

Utilizzare il metodo Close per chiudere un Connection, un Record, un Recordseto un oggetto Stream per liberare le risorse di sistema associate. La chiusura di un oggetto non la rimuove dalla memoria; è possibile modificare le impostazioni della proprietà e aprirla di nuovo in un secondo momento. Per eliminare completamente un oggetto dalla memoria, chiudere l'oggetto e quindi impostare la variabile oggetto su Nothing (in Visual Basic).

Connessione

L'utilizzo del metodo Close per chiudere un oggetto Connection chiude anche qualsiasi oggetto Recordset attivo associato alla connessione. Un oggetto Command associato all'oggetto Connection che si stanno chiudendo verrà mantenuto, ma non verrà più associato a un oggetto Connection; ovvero, la proprietà ActiveConnection verrà impostata su Nothing. Inoltre, l'insieme CommandParameters dell'oggetto verrà cancellato da qualsiasi parametro definito dal provider.

In un secondo momento è possibile chiamare il metodo Open per ristabilire la connessione alla stessa origine dati o a un'altra. Mentre l'oggetto Connection è chiuso, la chiamata a tutti i metodi che richiedono una connessione aperta all'origine dati genera un errore.

La chiusura di un oggetto Connection mentre sono presenti oggetti Recordset aperti nella connessione esegue il rollback di eventuali modifiche in sospeso in tutti gli oggetti Recordset . Chiusura esplicita di un oggetto Connection (chiamata al metodo Close) mentre una transazione è in corso genera un errore. Se un oggetto connection non rientra nell'ambito mentre è in corso una transazione, ADO esegue automaticamente il rollback della transazione.

Recordset, Record, Stream

Utilizzando il metodo Close per chiudere un oggetto Recordset , Recordo Stream rilascia i dati associati e qualsiasi accesso esclusivo ai dati tramite questo particolare oggetto . In seguito è possibile chiamare il metodo Open per riaprire l'oggetto con gli stessi attributi o modificati.

Mentre un oggetto Recordset è chiuso, la chiamata a tutti i metodi che richiedono un cursore attivo genera un errore.

Se è in corso una modifica in modalità di aggiornamento immediato, la chiamata al metodo close genera un errore; Chiamare invece prima il metodo Update o CancelUpdate. Se si chiude l'oggetto recordset in modalità di aggiornamento batch, tutte le modifiche apportate dall'ultima chiamata UpdateBatch andranno perse.

Se si utilizza il metodo Clone per creare copie di un oggetto Recordset aperto , la chiusura dell'originale o di un clone non influisce sulle altre copie.

Si applica a

Vedere anche

esempio di metodi Open e Close (VB)
esempio di metodi Open e Close (VBScript)
esempio di metodi Open e Close (VC++)
metodo Open (connessione ADO)
metodo Open (ADO Recordset)
Metodo Save