Close, méthode (ADO)

  • Article

Ferme un objet ouvert et tous les objets dépendants.

Syntaxe

  
object.Close

Notes

Utilisez la méthode Close pour fermer un objet Connection, Record, Recordset ou Stream afin de libérer toutes les ressources système associées. La fermeture d’un objet n’a pas pour effet de supprimer celui-ci de la mémoire. Vous pourrez modifier ses paramètres de propriété et le rouvrir ultérieurement. Pour éliminer complètement un objet de la mémoire, fermez-le, puis définissez la variable objet sur Nothing (en Visual Basic).

Connexion

L’utilisation de la méthode Close pour fermer un objet Connection ferme également tous les objets Recordset actifs associés à la connexion. Un objet Command associé à l’objet Connection que vous fermez persistera, mais ne sera plus associé à un objet Connection. Autrement dit, sa propriété ActiveConnection sera définie sur Nothing. En outre, la collection Parameters de l’objet Command sera effacée de tous les paramètres définis par le fournisseur.

Vous pourrez appeler ultérieurement la méthode Open pour rétablir la connexion à la même source de données ou à une autre. Pendant que l’objet Connection est fermé, l’appel de toute méthode nécessitant une connexion ouverte à la source de données génère une erreur.

La fermeture d’un objet Connection pendant que des objets Recordset sont ouverts sur la connexion a pour effet d’annuler toute modification en attente dans tous les objets Recordset. La fermeture explicite d’un objet Connection (appelant la méthode Close) pendant qu’une transaction est en cours génère une erreur. Si un objet Connection se trouve hors de portée pendant qu’une transaction est en cours, ADO annule automatiquement la transaction.

Recordset, Record, Stream

L’utilisation de la méthode Close pour fermer un objet Recordset, Record ou Stream libère les données associées, et tout accès exclusif à celles-ci que vous avez pu avoir via cet objet particulier. Vous pourrez appeler ultérieurement la méthode Open pour rouvrir l’objet avec les mêmes attributs, ou les attributs modifiés.

Pendant qu’un objet Recordset est fermé, l’appel de toute méthode nécessitant un curseur actif génère une erreur.

Si une modification est en cours en mode de mise à jour immédiate, l’appel de la méthode Close génère une erreur. À la place, appelez d’abord la méthode Update ou CancelUpdate. Si vous fermez l’objet Recordset en mode de mise à jour par lots, toutes les modifications apportées depuis le dernier appel UpdateBatch sont perdues.

Si vous utilisez la méthode Clone pour créer des copies d’un objet Recordset ouvert, la fermeture de l’original ou d’un clone n’affecte aucune des autres copies.

S'applique à

Connection, objet (ADO)
Record, objet (ADO)

Recordset, objet (ADO)
Stream, objet (ADO)

Voir aussi

Open et Close, exemple de méthodes (VB)
Open et Close, exemple de méthodes (VBScript)
Open et Close, exemple de méthodes (VC++)
Open, méthode (objet Connection ADO)
Open, méthode (objet Recordset ADO)
Save, méthode