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.