Método DoCmd.CopyObject (Access)
O método CopyObject executa a ação CopyObject no Visual Basic.
Sintaxe
expressão. CopyObject (DestinationDatabase, NewName, SourceObjectType, SourceObjectName)
expression Uma variável que representa um objeto DoCmd.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| DestinationDatabase | Opcional | Variantes | Uma expressão de cadeia de caracteres que é o caminho válido e o nome do arquivo para o banco de dados no qual você deseja copiar o objeto. Para selecionar o banco de dados atual, deixe este argumento em branco. OBSERVAÇÃO: em um projeto do Microsoft Access (.adp), você deve deixar o argumento DestinationDatabase em branco. Se você executar o código do Visual Basic que contém o método CopyObject em um banco de dados de biblioteca e deixar esse argumento em branco, o Access copiará o objeto no banco de dados da biblioteca. |
| Newname | Opcional | Variantes | Uma expressão de cadeia de caracteres que é o novo nome do objeto que você deseja copiar. Para usar o mesmo nome, se você estiver copiando em um outro banco de dados, deixe esse argumento em branco. |
| SourceObjectType | Opcional | AcObjectType | Uma constante AcObjectType que representa o tipo de objeto a ser copiado. |
| SourceObjectName | Opcional | Variantes | Uma expressão de cadeia de caracteres que é o nome válido de um objeto do tipo selecionado pelo argumento SourceObjectType . Se você executar o código Visual Basic que contém o método CopyObject 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 a ação CopyObject para copiar o objeto de banco de dados especificado para um banco de dados access diferente ou para o mesmo banco de dados ou projeto access (.adp) em um novo nome. Por exemplo, copie ou faça backup em um objeto existente em outro banco de dados ou crie rapidamente um objeto similar com poucas alterações.
Você deve incluir o argumento DestinationDatabase ou NewName ou ambos para este método.
Se você deixar os argumentos SourceObjectType e SourceObjectName em branco (a constante padrão, acDefault, é assumida para SourceObjectType), o Access copiará o objeto selecionado na janela Banco de Dados. Para selecionar um objeto na janela Banco de Dados, você pode usar a ação SelectObject ou o método SelectObject com o argumento InDatabaseWindow definido como Sim (True).
Se você especificar os argumentos SourceObjectType e SourceObjectName , mas deixar o argumento NewName ou o argumento DestinationDatabase em branco, deverá incluir a vírgula do argumento NewName ou DestinationDatabase . Se você deixar um argumento à direita em branco, não use uma vírgula seguindo o último argumento especificado.
Exemplo
O exemplo a seguir usa o método CopyObject para copiar a tabela Funcionários e dar-lhe um novo nome no banco de dados atual.
DoCmd.CopyObject, "Employees Copy", 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.