Méthode DoCmd.Rename (Access)

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

Syntaxe

expression. Rename (NewName, ObjectType, OldName)

expressionune variable représentant un objet DoCmd.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Newname	Obligatoire	Variant	Expression de chaîne qui est le nouveau nom de l’objet que vous souhaitez renommer. Ce nom doit être conforme aux règles d'appellation des objets Microsoft Access.
ObjectType	Facultatif	AcObjectType	Constante AcObjectType qui spécifie le type d’objet à renommer. La valeur par défaut est acDefault.
OldName	Facultatif	Variante	Expression chaîne qui est le nom valide d'un objet du type spécifié par l'argument ObjectType. Si vous exécutez du code Visual Basic contenant la méthode Rename 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 la méthode Rename pour renommer un objet de base de données spécifié.

Si vous laissez les arguments ObjectType et OldName vides (la constante par défaut, acDefault, est supposée pour ObjectType), Access renomme 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 la méthode SelectObject avec l’argument InDatabaseWindow défini sur Oui (True).

Exemple

L’exemple suivant renomme la table Employees .

DoCmd.Rename "Old Employees Table", 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.