Partager via


CopyRecord, méthode (ADO)

S’applique à : Access 2013, Office 2013

Copie une entité représentée par un objet Record vers un autre emplacement.

Syntaxe

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

Paramètres

Paramètre Description
Source Facultatif. Valeur de type String contenant une URL spécifiant l’entité à copier (par exemple, un fichier ou un répertoire). Si le paramètre Source est omis ou spécifie une chaîne vide, le fichier ou le répertoire représenté par l’objet Record actif est copié.
Destination Optional. Valeur de type String contenant une URL spécifiant l'emplacement dans lequel Source va être copié.
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 UserName.
Options Facultatif. Valeur de l'énumération CopyRecordOptionsEnum (par défaut, adCopyUnspecified ). Spécifie le comportement de cette méthode.
Async Facultatif. Valeur de type Boolean qui, lorsqu'elle correspond à True, indique que cette opération doit être asynchrone.

Valeur renvoyée

Valeur de type String qui retourne, en général, la valeur de Destination. Toutefois, la valeur exacte renvoyée dépend du fournisseur.

Remarques

Les valeurs des paramètres Source et Destination ne doivent pas être identiques sans quoi une erreur d'exécution se produit. Il faut au moins que le nom du serveur, du chemin d'accès ou de la ressource diffère.

Tous les enfants (par exemple, les sous-répertoires) de Source sont copiés de manière récursive sauf si la valeur adCopyNonRecursive est spécifiée. Dans une opération récursive, Destination ne doit pas correspondre à un sous-répertoire de Source sans quoi l'opération n'est pas exécutée.

Cette méthode échoue si Destination identifie une entité existante (par exemple, un fichier ou un répertoire) sauf si adCopyOverWrite est spécifié.

Importante

Soyez prudent lorsque vous utilisez l'option adCopyOverWrite. Si, par exemple, vous la spécifiez lors de la copie d'un fichier dans un répertoire, ce répertoire est supprimé et remplacé par le fichier.

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.