CopyRecord, méthode (ADO)
Copie une entité représentée par un enregistrement à un autre emplacement.
Syntaxe
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)
Paramètres
source
Optionnel. Valeur String qui contient une URL spécifiant l’entité à copier (par exemple, un fichier ou un répertoire). Si source est omise ou spécifie une chaîne vide, le fichier ou le répertoire représenté par l’enregistrement actuel sera copié.
de destination
Optionnel. Valeur string qui contient une URL spécifiant l’emplacement où source sera copié.
UserName
Optionnel. Valeur string qui contient l’ID d’utilisateur qui, si nécessaire, autorise l’accès à destination.
mot de passe
Optionnel. Valeur de string qui contient le mot de passe qui, le cas échéant, vérifie UserName.
options
Optionnel. Valeur CopyRecordOptionsEnum dont la valeur par défaut est adCopyUnspecified. Spécifie le comportement de cette méthode.
asynchrone
Optionnel. Valeur de booléenne qui, quand True, spécifie que cette opération doit être asynchrone.
Valeur de retour
Valeur string qui retourne généralement la valeur de Destination. 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 un serveur, un chemin d’accès ou un nom de ressource doit différer.
Tous les enfants (par exemple, 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, de 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 une entité existante (par exemple, un fichier ou un répertoire), sauf si adCopyOverWrite est spécifié.
Important
Utilisez l’option adCopyOverWrite judicieusement. Par exemple, la spécification de cette option lors de la copie d’un fichier dans un répertoire supprimer le répertoire et la remplacer par le fichier.
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.