Compartilhar via

Método DoCmd.CopyDatabaseFile (Access)

  • Artigo

Copia o banco de dados conectado ao projeto atual para um arquivo de banco de dados do Microsoft SQL Server que será exportado.

Sintaxe

expressão. CopyDatabaseFile (DatabaseFileName, OverwriteExistingFile, DisconnectAllUsers)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
DatabaseFileName Obrigatório Variant O nome do arquivo (e o caminho) para o qual o banco de dados será copiado. Se nenhum caminho for especificado, o diretório atual será usado.
OverwriteExistingFile Opcional Variantes Determina se o Microsoft Access substitui o arquivo especificado por DatabaseFileName. True para substituir o arquivo existente. Se o arquivo ainda não existir, esse argumento será ignorado.
DisconnectAllUsers Opcional Variantes Determina se o Access desconecta os usuários conectados ao banco de dados atual para fazer a cópia. True para desconectar outros usuários antes de copiar o arquivo de banco de dados.

Comentários

O nome do arquivo da cópia deve ter uma extensão .mdf para ser reconhecida como um arquivo de banco de dados SQL Server.

O método falhará e causará um erro, se ocorrer qualquer uma das seguintes condições:

  • DisconnectAllUsers é True , mas o Access não consegue assinar outros usuários.

  • O método cancela uma operação de salvamento feita por sessões de design abertas.

  • O arquivo de destino existe, mas OverwriteExistingFile não foi definido como True.

  • O arquivo de destino existe, mas está sendo usado por outro aplicativo.

  • O Access não pôde se reconectar ao arquivo .mdf original.

  • O usuário atual do projeto Access não tem privilégios de administrador do sistema para o servidor de banco de dados.

Exemplo

Este exemplo copia o banco de dados conectado ao projeto atual para um arquivo de banco de dados do SQL Server. Se o arquivo já existir, será substituído pelo Access e qualquer outro usuário conectado ao banco de dados será desconectado antes que a cópia seja feita.

DoCmd.CopySQLDatabaseFile _ 
 DatabaseFileName:="C:\Export\Sales.mdf", _ 
 OverwriteExistingFile:=True, _ 
 DisconnectAllUsers:=True

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.