Close, méthode (ADO)
Ferme un objet ouvert et tous les objets dépendants.
Syntaxe
object.Close
Remarques
Utilisez la méthode Close pour fermer un connection, un d’enregistrement, un jeu d’enregistrements ou un objet Stream pour libérer les ressources système associées. La fermeture d’un objet ne le supprime pas de la mémoire ; vous pouvez modifier ses paramètres de propriété et l’ouvrir ultérieurement. Pour éliminer complètement un objet de la mémoire, fermez l’objet, puis définissez la variable d’objet sur Nothing (en Visual Basic).
Connexion
L’utilisation de la méthode Close pour fermer un objet Connection ferme également tout objet Recordset actif associé à la connexion. Un objet Command associé à l’objet Connection que vous fermez persiste, mais il 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 pouvez ultérieurement appeler la méthode Open pour rétablir la connexion au même ou à une autre source de données. Alors que l’objet Connection est fermé, l’appel de toutes les méthodes qui nécessitent une connexion ouverte à la source de données génère une erreur.
La fermeture d’un objet Connection lorsqu’il existe objets Recordset ouverts sur la connexion restaure les modifications en attente dans tous les objets recordset . La fermeture explicite d’un objet Connection (appel de la méthode Close) pendant qu’une transaction est en cours génère une erreur. Si un objet Connection tombe hors de portée pendant qu’une transaction est en cours, ADO restaure automatiquement la transaction.
Recordset, Record, Stream
L’utilisation de la méthode Close pour fermer un jeu d’enregistrements , d’enregistrement ou objet Stream libère les données associées et tout accès exclusif que vous avez peut-être dû aux données via cet objet particulier. Vous pouvez appeler ultérieurement la méthode Open pour rouvrir l’objet avec les mêmes attributs, ou modifiés.
Alors qu’un objet Recordset est fermé, l’appel de toutes les méthodes nécessitant un curseur en direct 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 ; Appelez la méthode Update ou CancelUpdate en premier. Si vous fermez l’objet Recordset en mode de mise à jour par lots, toutes les modifications apportées depuis la dernière UpdateBatch appel 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 Object (ADO)
Record, objet (ADO)
Voir aussi
méthodes Open et Close , exemple (VB)
méthodes Open et Close , exemple (VBScript)
méthodes Open et Close, exemple (VC++)
Open, méthode (connexion ADO)
Open, méthode (jeu d’enregistrements ADO)
Save, méthode