MoveRecord, méthode (ADO)
S’applique à : Access 2013, Office 2013
Déplace l’entité représentée par un objet Record vers un autre emplacement.
Syntaxe
Enregistrement. MoveRecord (Source, Destination, UserName, Password, Options, Async)
Paramètres
| Paramètre | Description |
|---|---|
| Source | Facultatif. Valeur de type String qui contient une URL identifiant l'objet Record à déplacer. Si Source est omis ou spécifie une chaîne vide, l'objet représenté par cet enregistrement est déplacé. Par exemple si l'objet Record représente un fichier, le contenu du fichier est déplacé vers l'emplacement spécifié par le paramètre Destination. |
| Destination | Optional. Valeur de type String qui contient une URL spécifiant l'emplacement vers lequel déplacer Source . |
| UserName | Optional. Valeur de type String contenant l'ID utilisateur, qui le cas échéant, autorise l'accès à Destination. |
| Password | Optional. Valeur de type String contenant le mot de passe qui, le cas échéant, vérifie le paramètre NomUtilisateur. |
| Options | Facultatif. Valeur MoveRecordOptionsEnum dont la valeur par défaut est adMoveUnspecified. Spécifie le comportement de cette méthode. |
| Async | Optional. Valeur booléenne qui, quand elle est True, spécifie cette opération doit être asynchrone. |
Valeur renvoyée
Valeur de type String. En général, il s'agit de la valeur de Destination. Toutefois, la valeur retournée précise dépend du fournisseur.
Remarques
Les valeurs de Source et Destination ne peuvent pas être identiques sans quoi une erreur d'exécution se produit. Il faut au moins que les noms de ressource, de chemin d'accès et de serveur diffèrent.
Pour les fichiers déplacés à l'aide du fournisseur de la publication Internet, cette méthode met à jour tous les liens hypertexte dans les fichiers déplacés sauf indication contraire précisée dans Options. Cette méthode échoue si Destination identifie un objet existant (fichier ou répertoire, par exemple), à moins que adMoveOverWrite soit spécifié.
Remarque
Soyez prudent lorsque vous utilisez l'option adMoveOverWrite. Si, par exemple, vous spécifiez cette option lorsque vous déplacez un fichier vers un répertoire, le répertoire est supprimé et remplacé par le fichier.
Certain attributes of the Record object, such as the ParentURL property, will not be updated after this operation completes. Refresh the Record object's properties by closing the Record, then re-opening it with the URL of the location where the file or directory was moved.
Si l'objet Record a été obtenu d'un objet Recordset, le nouvel emplacement du fichier ou répertoire déplacé n'est pas directement reflété dans l'objet Recordset. Actualisez l’objet Recordset en le fermant puis en le rouvrant.
Remarque
Les URL qui utilisent le schéma http appellent automatiquement le fournisseur Microsoft OLE DB pour la publication Internet. Pour plus d’informations, consultez URL absolues et relatives.