Ação da macro SalvarObjeto

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação SalvarObjeto para salvar um objeto do Access especificado ou, se nenhum estiver especificado, o objeto ativo. Em alguns casos, pode também salvar o objeto ativo com um novo nome (tem o mesmo efeito do comando Salvar como na Barra de Ferramentas de Acesso Rápido).

Observação

Essa ação não será permitida se o banco de dados não for confiável.

Setting

A ação SalvarObjeto tem os seguintes argumentos.

Argumento da ação	Descrição
Tipo de Objeto	O tipo de objeto que você deseja salvar. Clique em Tabela, Consulta, Formulário, Relatório, Macro, Módulo, Página de Acesso a Dados, Modo de Exibição do Servidor, Diagrama, Procedimento Armazenado ou Função na caixa Tipo de Objeto, na seção Argumentos da Ação do painel Construtor de Macros. Para selecionar o objeto ativo, deixe este argumento em branco. Se você selecionar um tipo de objeto no argumento, selecione um nome de objeto existente no argumento Nome do Objeto.
Nome do Objeto	O nome do objeto a ser salvo. A caixa Nome do Objeto mostra todos os objetos do banco de dados, do tipo selecionado pelo argumento Tipo de objeto. Se deixar em branco o argumento Tipo de objeto, você poderá deixar este argumento em branco para salvar o objeto ativo ou, em alguns casos, digitar um novo nome neste argumento para salvar o objeto ativo com esse nome. Se digitar um novo nome, você deverá cumprir as convenções de nomeação padrão para objetos do Microsoft Access.

Comentários

A ação SalvarObjeto funciona em todos os objetos de banco de dados que o usuário possa explicitamente abrir e salvar. O objeto especificado deve estar aberto para que a ação SalvarObjeto tenha qualquer efeito no objeto. Essa ação é semelhante à ação de selecionar um objeto e salvá-lo clicando em Salvar na Barra de Ferramentas de Acesso Rápido.

Deixar em branco o argumento Tipo de Objeto e inserir um novo nome no argumento Nome do Objeto tem o mesmo efeito de clicar em Salvar Como na Barra de Ferramentas de Acesso Rápido e digitar um novo nome para o objeto ativo. O uso da ação SalvarObjeto permite que você especifique um objeto a ser salvo e execute um comando Salvar Como em uma macro.

Observação

[!OBSERVAçãO] A ação SalvarObjeto não pode ser utilizada para salvar nenhum dos seguintes itens com um novo nome:

• Um formulário no modo de exibição de formulário ou folha de dados
• Um relatório em Visualização de Impressão
• Um módulo
• Uma exibição de servidor no modo de exibição folha de dados ou visualização de impressão
• Uma página de acesso a dados no modo de exibição de página
• Uma tabela no modo de exibição Folha de Dados ou Visualização de Impressão
• Uma consulta no modo de exibição folha de dados ou visualização de impressão
• Um procedimento armazenado na exibição datasheet ou visualização de impressão

A ação SalvarObjeto, esteja ela carregada em uma macro em execução no banco de dados atual ou em um banco de dados biblioteca, sempre salva o objeto especificado ou o objeto ativo do banco de dados em que o objeto foi criado.

Se você salvar o objeto com um novo nome, mas o nome for o mesmo de um objeto existente desse tipo, uma caixa de diálogo perguntará se você deseja substituir o objeto existente. Se tiver definido o argumento Avisos ativos da ação DefinirAvisos como Não, a caixa de diálogo não será exibida e o objeto antigo será automaticamente substituído.

Para executar a ação SalvarObjeto em um módulo do VBA (Visual Basic for Applications), use o método Salvar do objeto DoCmd.