Partager via

MoveRecord, méthode (ADO)

  • Article

Déplace l’entité représentée par un Record vers un autre emplacement.

Syntaxe

  
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)

Paramètres

Source
facultatif. Valeur String qui contient une URL identifiant l’objet Record à déplacer. Si la source est omise ou spécifie une chaîne vide, l’objet représenté par ce Record 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 Destination.

Destination
facultatif. Valeur String qui contient une URL spécifiant l’emplacement où la Source sera déplacée.

UserName
facultatif. Valeur String qui contient l’ID utilisateur qui, si nécessaire, autorise l’accès à Destination.

Mot de passe
facultatif. Une valeur String qui contient le mot de passe et qui, si nécessaire, vérifie UserName.

Options
facultatif. Valeur MoveRecordOptionsEnum dont la valeur par défaut est adMoveUnspecified. Spécifie le comportement de cette méthode.

Asynchrone
facultatif. Valeur Booléenne qui, lorsqu’elle vaut True, spécifie que cette opération doit être asynchrone.

Valeur de retour

Valeur de chaîne. En règle générale, la valeur de Destination est retournée. Toutefois, la valeur exacte retournée dépend du fournisseur.

Notes

Les valeurs de Source et Destination ne doivent pas être identiques ; sinon, une erreur d’exécution se produit. Au minimum, les noms de serveur, de chemin d’accès et de ressource 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 avec les 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é.

Notes

Utilisez l’option adMoveOverWrite de manière avec vigilance. Par exemple, la spécification de cette option lors du déplacement d’un fichier vers un répertoire supprime le répertoire et le remplace par le fichier.

Certains attributs de l’objet Record, comme la propriété ParentURL, ne seront pas mis à jour une fois cette opération terminée. Actualisez les propriétés de l’objet Record en fermant le Record, puis en l’ouvrant à nouveau avec l’URL de l’emplacement où le fichier ou le répertoire a été déplacé.

Si ce Record a été obtenu à partir d’un Recordset, le nouvel emplacement du fichier ou du répertoire déplacé ne sera pas immédiatement répercuté dans l’objet Recordset. Actualisez l’objet Recordset en le fermant et en le rouvrant.

Notes

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 à

Record, objet (ADO)

Voir aussi

Move, méthode (ADO)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (ADO)
MoveFirst, MoveLast, MoveNext et MovePrevious, méthodes (RDS)