Partager via

CopyRecord, méthode (ADO)

  • Article

Copie une entité représentée par un enregistrement à un autre emplacement.

Syntaxe

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

Paramètres

Source
facultatif. Une valeur String qui contient une URL spécifiant l’entité à copier (par exemple, un fichier ou un répertoire). Si laSource est omise ou spécifie une chaîne vide, l’entité représentée par l’enregistrement actif est supprimée.

Destination
facultatif. Une 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. Une valeur CopyRecordOptionsEnum qui a une valeur par défaut adCopyUnspecified. Spécifie le comportement de cette méthode.

Asynchrone
facultatif. Une valeur Booléenne qui, lorsqu’elle est définir sur True, spécifie que cette opération doit être asynchrone.

Valeur renvoyée

Une valeur String qui retourne généralement la valeur de destination. 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 moins l’un des noms de serveur, de chemin ou de ressource doit différer.

Tous les enfants (par exemple, les sous-répertoires) de source sont copiés de manière récursive, sauf si adCopyNonRecursive est spécifié. Dans une opération récursive, la destination ne doit pas être un sous-répertoire de source ; sinon, l’opération n’est pas terminée.

Cette méthode échoue si Destination identifie un objet existant (par exemple, un fichier ou un répertoire), sauf si adMoveOverWrite est spécifié.

Important

Utilisez l’option adCopyOverWrite de manière judicieuse. Par exemple, la spécification de cette option lors de la copie d’un fichier dans un répertoire supprime le répertoire et la remplace par le fichier.

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)