Méthode DoCmd.CopyObject (Access)

La méthode CopyObject exécute l’action CopyObject dans Visual Basic.

Syntaxe

expression. CopyObject (DestinationDatabase, NewName, SourceObjectType, SourceObjectName)

expressionune variable représentant un objet DoCmd.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
DestinationDatabase	Facultatif	Variant	Expression de chaîne qui est le chemin d’accès et le nom de fichier valides pour la base de données dans laquelle vous souhaitez copier l’objet. Pour sélectionner la base de données active, laissez cet argument vide. REMARQUE : Dans un projet Microsoft Access (.adp), vous devez laisser l’argument DestinationDatabase vide. Si vous exécutez du code Visual Basic contenant la méthode CopyObject dans une base de données bibliothèque et que vous laissez cet argument vide, Access copie l’objet dans la base de données de bibliothèque.
Newname	Facultatif	Variant	Expression de chaîne qui est le nouveau nom de l’objet que vous souhaitez copier. Si vous copiez l'objet dans une autre base de données, laissez cet argument vierge pour conserver son nom d'origine.
SourceObjectType	Facultatif	AcObjectType	Constante AcObjectType qui représente le type d’objet à copier.
SourceObjectName	Facultatif	Variant	Expression de chaîne qui est le nom valide d’un objet du type sélectionné par l’argument SourceObjectType . Si vous exécutez du code Visual Basic contenant la méthode CopyObject dans une base de données bibliothèque, Access recherche d’abord l’objet portant ce nom dans la base de données bibliothèque, puis dans la base de données active.

Remarques

Utilisez l’action CopierObject pour copier l’objet de base de données spécifié dans une autre base de données Access ou dans la même base de données ou projet Access (.adp) sous un nouveau nom. Par exemple, vous pouvez copier ou enregistrer un objet existant dans une autre base de données ou créer rapidement un objet similaire en n'apportant que quelques modifications.

Vous devez inclure l’argument DestinationDatabase ou NewName , ou les deux pour cette méthode.

Si vous laissez les arguments SourceObjectType et SourceObjectName vides (la constante par défaut, acDefault, est supposée pour SourceObjectType), Access copie l’objet sélectionné dans la fenêtre Base de données. Pour sélectionner un objet dans la fenêtre Base de données, vous pouvez utiliser l’action SelectObject ou la méthode SelectObject avec l’argument InDatabaseWindow défini sur Oui (True).

Si vous spécifiez les arguments SourceObjectType et SourceObjectName , mais que vous laissez l’argument NewName ou l’argument DestinationDatabase vides, vous devez inclure la virgule de l’argument NewName ou DestinationDatabase . Si vous laissez un argument de fin vide, n’utilisez pas de virgule après le dernier argument que vous spécifiez.

Exemple

L’exemple suivant utilise la méthode CopyObject pour copier la table Employees et lui attribuer un nouveau nom dans la base de données active.

DoCmd.CopyObject, "Employees Copy", acTable, "Employees"

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.