Save, méthode (ADO)
S’applique à : Access 2013, Office 2013
Enregistre l’objet Recordset dans un fichier ou un objet Stream.
Syntaxe
recordset. Enregistrerla destination, PersistFormat
Paramètres
| Paramètre | Description |
|---|---|
| Destination | Facultatif. Valeur de type Variant qui représente le nom de chemin d'accès complet du fichier dans lequel l'objet Recordset doit être enregistré ou une référence à l'objet Stream. |
| PersistFormat | Facultatif. Valeur PersistFormatEnum qui spécifie le format d'enregistrement de l'objet Recordset (XML ou ADTG). La valeur par défaut est adPersistADTG. |
Remarques
La méthode Save peut uniquement être appelée sur un objet Recordset ouvert. Utilisez la méthode Open pour restaurer ultérieurement l’objet Recordset à partir de Destination.
Si la propriété Filter est appliquée pour l'objet Recordset, seules les lignes accessibles sous le filtre sont enregistrées. Si l'objet Recordset est hiérarchique, l'objet Recordset enfant actif et ses enfants sont enregistrés, y compris l'objet Recordset parent. Si la méthode Save d'un objet Recordset enfant est appelée, l'enfant et tous ses enfants sont enregistrés mais pas l'objet parent.
La première fois que vous enregistrez le jeu d’enregistrements, il n’est pas nécessaire d’indiquer une destination. Si vous oubliez la destination, un nouveau fichier est créé et nommé selon la valeur de la propriété Source du jeu d’enregistrements.
Omettez Destination lors des appels à Save suivant le premier enregistrement sans quoi une erreur d'exécution se produit. Si, par la suite, vous appelez Save avec un nouveau paramètre Destination, l'objet Recordset est enregistré dans la nouvelle destination. Toutefois, la nouvelle destination et la destination d'origine seront toutes deux ouvertes.
Dans la mesure où Save ne ferme pas l'objet Recordset ni Destination, vous pouvez continuer à travailler avec l'objet Recordset et enregistrer vos modifications les plus récentes. Le paramètre Destination reste ouvert jusqu'à la fermeture de l'objet Recordset.
Pour des raisons de sécurité, la méthode Save autorise uniquement l'utilisation de paramètres de sécurité basse et personnalisée à partir d'un script exécuté par Microsoft Internet Explorer. Pour obtenir une explication plus détaillée des problèmes de sécurité, consultez l'article traitant des problèmes de sécurité ADO et RDS dans Microsoft Internet Explorer, figurant dans la rubrique des articles techniques sur les objets ADO (ActiveX Data Object) dans la base des articles techniques traitant de l'accès aux données.
Si une méthode Save est invoquée alors qu'une opération asynchrone de mise à jour, d'exécution ou d'extraction d'un jeu d'enregistrements est en cours, la méthode Save attend la fin de l'opération asynchrone.
Les enregistrements sont enregistrés en commençant par la première ligne de l'objet Recordset. Une fois l'exécution de la méthode Save terminée, la position de ligne active est déplacée à la première ligne de l'objet Recordset.
Pour obtenir de meilleurs résultats, affectez à la propriété CursorLocation la valeur adUseClient avec la méthode Save. Si votre fournisseur ne prend pas en charge toutes les fonctionnalités nécessaires à l'enregistrement des objets Recordset, le service de curseur les fournira.
Lorsqu'un objet Recordset est conservé avec la propriété CursorLocation affectée de la valeur adUseServer, les fonctionnalités de mise à jour de l'objet Recordset sont limitées. En général, seules les mises à jour, les insertions et les suppressions de table unique sont autorisées (selon les fonctionnalités du fournisseur). La méthode Resync n'est pas non plus disponible avec une telle configuration.
Remarque
[!REMARQUE] L'enregistrement d'un objet Recordset avec des champs de type adVariant, adIDispatch ou adIUnknown n'est pas pris en charge par ADO et peut avoir des résultats imprévisibles.
Seuls les filtres sous forme de chaînes de critères (par exemple, OrderDate > '31/12/1999') affectent le contenu d’un objet Recordset persistant. Les filtres créés avec un tableau de signets ou à l’aide d’une valeur de FilterGroupEnum n’affectent pas le contenu de l’objet Recordset persistant. Ces règles s'appliquent aux jeux d'enregistrements créés avec des curseurs côté client ou côté serveur.
Dans la mesure où le paramètre Destination peut accepter n’importe quel objet qui prend en charge l’interface OLE DB IStream, vous pouvez enregistrer un objet Recordset directement dans un objet de réponse ASP. Pour plus d’informations, consultez Scénario de persistance des objets Recordset XML.
Vous pouvez également enregistrer un objet Recordset au format XML dans une instance d'un objet DOM MSXML, comme l'illustre le code Visual Basic suivant :
Remarque
[!REMARQUE] L'enregistrement des objets Recordset hiérarchiques (formes de données) au format XML est assorti de deux limitations. Vous ne pouvez pas enregistrer au format XML si l'objet Recordset hiérarchique contient des mises à jour en attente et vous ne pouvez pas enregistrer un objet Recordset hiérarchique paramétré.
Un jeu d'enregistrements enregistré au format XML est enregistré à l'aide du format UTF-8. Lorsque ce type de fichier est chargé dans un flux ADO, l'objet Stream ne tente pas d'ouvrir l'objet Recordset à partir du flux sauf si la propriété Charset du flux a la valeur appropriée pour le format UTF-8.