MoveRecord, méthode (ADO)
Déplace l’entité représentée par un enregistrement vers un autre emplacement.
Syntaxe
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)
Paramètres
source
Optionnel. Valeur string qui contient une URL identifiant l'Record à déplacer. Si source est omise ou spécifie une chaîne vide, l’objet représenté par cette Record est déplacé. Par exemple, si l’enregistrement représente un fichier, le contenu du fichier est déplacé vers l’emplacement spécifié par destination.
de destination
Optionnel. Valeur string qui contient une URL spécifiant l’emplacement où source sera déplacé.
UserName
Optionnel. Valeur string qui contient l’ID d’utilisateur qui, si nécessaire, autorise l’accès à destination.
mot de passe
Optionnel. Une de chaîne qui contient le mot de passe qui, le cas échéant, vérifie UserName.
options
Optionnel. Valeur MoveRecordOptionsEnum dont la valeur par défaut est adMoveUnspecified. Spécifie le comportement de cette méthode.
asynchrone
Optionnel. Valeur de booléenne qui, quand True, spécifie cette opération doit être asynchrone.
Valeur de retour
Valeur de string. En règle générale, la valeur de destination est retournée. Toutefois, la valeur exacte retournée dépend du fournisseur.
Remarques
Les valeurs de source et de destination ne doivent pas être identiques ; sinon, une erreur d’exécution se produit. Au moins le serveur, le chemin d’accès et les noms de ressources doivent différer.
Pour les fichiers déplacés à l’aide du fournisseur de publication Internet, cette méthode met à jour tous les liens hypertexte dans les fichiers déplacés, sauf indication contraire de Options. Cette méthode échoue si Destination identifie un objet existant (par exemple, un fichier ou un répertoire), sauf si adMoveOverWrite est spécifié.
Note
Utilisez l’option adMoveOverWrite judicieusement. Par exemple, la spécification de cette option lors du déplacement d’un fichier vers un répertoire supprime le répertoire et la remplace par le fichier.
Certains attributs de l’objet Record, tels que la propriété ParentURL, ne seront pas mis à jour une fois cette opération terminée. Actualisez les propriétés de l'Record objet en fermant le d’enregistrement, puis en l’ouvrant à nouveau avec l’URL de l’emplacement où le fichier ou le répertoire a été déplacé.
Si cette Record a été obtenue à partir d’un jeu d’enregistrements , le nouvel emplacement du fichier ou du répertoire déplacé ne sera pas immédiatement reflété dans le jeu d’enregistrements . Actualisez le jeu d’enregistrements en fermant et en le rouvrant.
Note
Les URL utilisant le schéma http appellent automatiquement le fournisseur Microsoft OLE DB pour la publication Internet. Pour plus d’informations, consultez URL absolues et relatives.
S’applique à
Voir aussi
Move, méthode (ADO)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (ADO)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (RDS)