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.