Método DoCmd.TransferDatabase (Access)

O método TransferDatabase executa a ação TransferDatabase no Visual Basic.

Sintaxe

expression.TransferDatabase (TransferType, DatabaseType, DatabaseName, ObjectType, Source, Destination, StructureOnly, StoreLogin)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
TransferType	Optional	AcDataTransferType	O tipo de transferência que você deseja fazer.
DatabaseType	Optional	Variantes	Uma expressão da cadeia de caracteres que é o nome de um dos tipos de bancos de dados que você pode usar para importar, exportar ou vincular dados. O parâmetro DatatbaseType é necessário para exportar e vincular ações de dados, mas não é necessário para a importação de ações. Os tipos ou bancos de dados são: Microsoft Access (padrão) Jet 2.x Jet 3.x dBase III dBase IV dBase 5.0 Paradox 3.x Paradox 4.x Paradox 5.x Paradox 7.x Banco de dados ODBC WSS (Microsoft Office SharePoint Online)
DatabaseName	Optional	Variant	Uma expressão de cadeia de caracteres que é o nome completo, incluindo o caminho (para WSS, Windows Microsoft Windows SharePoint Services, a URL), do banco de dados que você deseja usar para importar, exportar ou vincular dados.
ObjectType	Optional	AcObjectType	O tipo de objeto a ser importado ou exportado.
Fonte	Opcional	Variantes	Uma expressão de cadeia de caracteres que é o nome do objeto cujos dados você deseja importar, exportar ou vincular.
Destino	Opcional	Variantes	Uma expressão de cadeia de caracteres que é o nome do objeto importado, exportado ou vinculado no banco de dados de destino.
StructureOnly	Optional	Variantes	Use True (1) para importar ou exportar somente a estrutura de uma tabela de banco de dados. Use False (0) para importar ou exportar a estrutura da tabela e seus dados. Se você deixar esse argumento em branco, o padrão (False) é assumido.
StoreLogin	Optional	Variantes	Use True para armazenar a identificação de entrada (ID) e a senha para um banco de dados ODBC na cadeia de conexão para uma tabela vinculada do banco de dados. Se você fizer isso, não é necessário entrar em cada vez que você abrir a tabela. Use False se você não quiser armazenar a identificação de entrada e senha. Se você deixar esse argumento em branco, o padrão (False) é assumido. Esse argumento só está disponível no Visual Basic.

Comentários

Use a ação TransferDatabase para importar ou exportar dados entre o banco de dados atual do Microsoft Access ou o projeto do Access (.adp) e outro banco de dados. Para bancos de dados do Microsoft Access, você também pode vincular uma tabela ao banco de dados atual do Access de outro banco de dados. Com uma tabela vinculada, você tem acesso aos dados da tabela enquanto a própria tabela permanece em outro banco de dados.

Você pode importar e exportar tabelas entre o Access e outros tipos de bancos de dados. Também é possível exportar consultas seleção do Access para outros tipos de bancos de dados. O Access exporta o conjunto de resultados da consulta no formato de uma tabela. Você poderá importar e exportar qualquer objeto de banco de dados do Access caso ambos os bancos de dados sejam bancos de dados do Access.

Se você importar uma tabela de outro banco de dados do Access que seja uma tabela vinculada naquele banco de dados, ela ainda estará vinculada após a importação. Ou seja, o link é importado, e não a própria tabela.

O administrador de um banco de dados ODBC pode desabilitar o recurso fornecido pelo argumento SaveLoginId, exigindo que todos os usuários insiram a identificação de entrada e senha sempre que se conectem ao banco de dados ODBC.

Observação

Você também pode usar o ActiveX Data Objects (ADO) para criar um link usando a propriedade ActiveConnection para o objeto Recordset.

Exemplo

O exemplo a seguir importa o Relatório Mensal de Vendas do banco de dados do Access Northwind.accdb para o Relatório de Vendas Corporativas no banco de dados atual.

DoCmd.TransferDatabase acImport, "Microsoft Access", _ 
    "C:\Users\Public\Northwind.accdb", acReport, "Monthly Sales Report", _ 
    "Corporate Sales Report"

O exemplo a seguir vincula a tabela Authors do banco de dados ODBC ao banco de dados atual.

DoCmd.TransferDatabase acLink, "ODBC Database", _ 
    "ODBC;DSN=DataSource1;UID=User2;PWD=www;LANGUAGE=us_english;" & _ 
    "DATABASE=pubs", acTable, "Authors", "dboAuthors"

O exemplo a seguir importa uma lista do Microsoft Office SharePoint Online para uma tabela no banco de dados atual:

DoCmd.TransferDatabase acImport, "WSS", _
    "WSS;DATABASE=https://company-my.sharepoint.com/personal/username_domain_com/express;" & _
    "LIST=NameOfListToImport;RetrieveIds=Yes", _
    acTable, , "NameOfLocalTable", False

O exemplo a seguir exporta uma tabela no banco de dados atual para uma lista no Microsoft Office SharePoint Online:

DoCmd.TransferDatabase acExport, "WSS", _
    "https://company-my.sharepoint.com/personal/username_domain_com/express", _
    acTable, "NameOfLocalTable", "NameOfListInSharePoint", False

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.