Close, méthode (ADO)
S’applique à : Access 2013, Office 2013
Ferme un objet ouvert, ainsi que tous les objets qui en dépendent.
Syntaxe
object.Close
Remarques
Utilisez la méthode Close pour fermer un objet Connection, Record, Recordset ou Stream et libérer ainsi toutes les ressources système associées. La fermeture d'un objet n'entraîne pas sa suppression de la mémoire ; vous pouvez modifier ses paramètres de propriété et le rouvrir ultérieurement. Pour éliminer complètement un objet de la mémoire, définissez la variable objet sur Nothing (en Visual Basic) après avoir fermé l’objet.
Connection
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 est conservé, 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 est effacée de tous les paramètres définis par le fournisseur.
Vous pouvez ensuite appeler la méthode Open pour rétablir la connexion à la même source de données ou à une source de données différente. Lorsque l'objet Connection est fermé, l'appel d'une méthode nécessitant une connexion ouverte à la source de données génère une erreur.
Lorsque vous fermez un objet Connection alors que des objets Recordset sont ouverts sur la connexion, les modifications en attente dans tous les objets Recordset sont annulées. La fermeture explicite d'un objet Connection (par un appel de la méthode Close ) alors qu'une transaction est en cours génère une erreur. Si un objet Connection devient hors de portée lorsqu'une transaction est en cours, ADO restaure automatiquement la transaction.
Objets Recordset, Record et Stream
L'utilisation de la méthode Close pour fermer un objet Recordset, Record ou Stream libère les données associées, ainsi que tout accès exclusif aux données dont vous disposiez via cet objet spécifique. Vous pouvez appeler ultérieurement la méthode Open pour rouvrir l'objet avec les mêmes attributs ou avec des attributs modifiés.
Lorsqu'un objet Recordset est fermé, l'appel d'une méthode nécessitant un curseur actif génère une erreur.
Lorsqu'une modification est en cours en mode de mise à jour immédiate, l'appel de la méthode Close génère une erreur ; vous devez appeler, au préalable, la méthode Update ou CancelUpdate. Si vous fermez l'objet Recordset en mode de mise à jour par lot, toutes les modifications apportées depuis le dernier appel de la méthode UpdateBatch sont perdues.
Si vous utilisez la méthode Clone pour créer des copies d'un objet Recordset ouvert, la fermeture de l'objet d'origine ou d'un clone n'affecte pas les autres copies.