Compartilhar via


Método DoCmd.TransferSpreadsheet (Access)

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

Sintaxe

expression.TransferSpreadsheet (TransferType, SpreadsheetType, TableName, FileName, HasFieldNames, Range, UseOA)

expressão 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. O valor padrão é acImport.
SpreadsheetType Optional AcSpreadSheetType O tipo de planilha de onde importar, para onde exportar ou ao qual vincular.
TableName Opcional Variant Uma expressão de cadeia de caracteres que é o nome da tabela do Office Access para a qual você deseja importar dados de planilha, da qual deseja exportar dados de planilha ou para a qual deseja vincular dados de planilha, ou a consulta seleção do Access cujos resultados você deseja exportar para uma planilha.
FileName Opcional Variant Uma expressão de cadeia de caracteres que é o nome do arquivo e o caminho da planilha para a qual você deseja importar ou vincular ou da qual deseja importar.
HasFieldNames Opcional Variant Use True (1) para usar a primeira linha da planilha como nomes de campo ao importar ou vincular. Use False (0) para tratar a primeira linha da planilha como dados normais. Se você deixar esse argumento em branco, o padrão (False) é assumido. Quando você exporta a tabela do Access ou seleciona os dados da consulta para uma planilha, os nomes dos campos são inseridos na primeira linha da planilha, independentemente do que você insira para esse argumento.
Range Opcional Variantes Uma expressão de cadeia de caracteres que é um intervalo válido de células ou o nome de um intervalo na planilha. Esse argumento se aplica somente à importação. Deixe esse argumento em branco para importar a planilha inteira. Quando você exportar para uma planilha, deverá deixar esse argumento em branco. Se você inserir um intervalo, a exportação falhará.
UseOA Opcional Variant Não há suporte para este argumento.

Comentários

Use o método TransferSpreadsheet para importar ou exportar dados entre o banco de dados atual do Access ou o projeto do Access (.adp) e um arquivo de planilha. Você também pode vincular os dados em uma planilha do Excel ao banco de dados atual do Access. Com uma planilha relacionada, você pode visualizar e editar os dados da planilha com o Access enquanto ainda permite o acesso completo aos dados a partir do seu programa de planilhas do Excel. Você também pode vincular a dados em um arquivo de planilha do Lotus 1-2-3, mas esses dados estão no formato de somente leitura no Access.

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 os dados do intervalo da planilha Newemps.wk3 do Lotus para a tabela Employees do Access. Ele usa a primeira linha da planilha como nomes de campos.

DoCmd.TransferSpreadsheet acImport, 3, _ 
 "Employees","C:\Lotus\Newemps.wk3", True, "A1:G12"

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.