Método DoCmd.Rename (Access)

O método Rename realiza a ação Renomear no Visual Basic.

Sintaxe

expressão. Renomear (NewName, ObjectType, OldName)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Newname	Obrigatório	Variantes	Uma expressão de cadeia de caracteres que é o novo nome para o objeto que você deseja renomear. O nome deve seguir as regras de nomenclatura de objetos para objetos do Microsoft Access.
ObjectType	Optional	AcObjectType	Uma constante AcObjectType que especifica o tipo de objeto a ser renomeado. O valor padrão é acDefault.
Oldname	Opcional	Variantes	Uma expressão de cadeia de caracteres que é o nome válido de um objeto do tipo especificado pelo argumento ObjectType. Se você executar o código do Visual Basic que contém o método Rename em um banco de dados de biblioteca, o Access procurará o objeto com esse nome primeiro no banco de dados da biblioteca e, em seguida, no banco de dados atual.

Comentários

Use o método Rename para renomear um objeto de banco de dados especificado.

Se você deixar os argumentos ObjectType e OldName em branco (a constante padrão, acDefault, é assumida para ObjectType), o Access renomeará o objeto selecionado na janela Banco de Dados. Para selecionar um objeto na janela Banco de Dados, você pode usar o método SelectObject com o argumento InDatabaseWindow definido como Sim (True).

Exemplo

O exemplo a seguir renomeia a tabela Funcionários .

DoCmd.Rename "Old Employees Table", acTable, "Employees"

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.