TransferText Method

Applies To

DoCmd object.

Description

The TransferText method carries out the TransferText action in Visual Basic. For more information on how the action and its arguments work, see the action topic.

Syntax

DoCmd.TransferText [transfertype][, specificationname], tablename, filename
ú[, hasfieldnames][, HTMLtablename]

The TransferText method has the following arguments.

Argument	Description

transfertype	One of the following intrinsic constants:
	acExportDelim acExportFixed acExportHTML acExportMerge acImportDelim (default) acImportFixed acImportHTML acLinkDelim acLinkFixed acLinkHTML

(continued)

	If you leave this argument blank, the default constant (acImportDelim) is assumed.
	Note You can link to data in a text file or HTML file, but this data is read-only in Microsoft Access.
specificationname	A string expression that's the name of an import or export specification you've created and saved in the current database.
	This argument is required for fixed-width text files. For delimited text files and Microsoft Word mail merge data files, you can leave this argument blank to select the default import/export specifications.
tablename	A string expression that's the name of the Microsoft Access table you want to import text data to, export text data from, or link text data to, or the Microsoft Access select query whose results you want to export to a text file.
filename	A string expression that's the full name, including the path, of the text file you want to import from, export to, or link to.
hasfieldnames	Use True (–1) to use the first row of the text file as field names when importing, exporting, or linking. Use False (0) to treat the first row of the text file as normal data. If you leave this argument blank, the default (False) is assumed.
	This argument is ignored for Microsoft Word mail merge data files, which must always contain the field names in the first row.
HTMLtablename	A string expression that's the name of the table or list in the HTML file that you want to import or link. This argument is ignored unless the transfertype argument is set to acImportHTML or acLinkHTML. If you leave this argument blank, the first table or list in the HTML file is imported or linked.
	The name of the table or list in the HTML file is determined by the text specified by the <CAPTION> tag, if there's a <CAPTION> tag. If there's no <CAPTION> tag, the name is determined by the text specified by the <TITLE> tag. If more than one table or list has the same name, Microsoft Access distinguishes them by adding a number to the end of each table or list name; for example, Employees1 and Employees2.

Remarks

You can leave an optional argument blank in the middle of the syntax, but you must include the argument's comma. If you leave a trailing argument blank, don't use a comma following the last argument you specify.

Note Although you can use the TransferText method in Visual Basic to link to text data, it's recommended that you use Data Access Objects (DAO) instead. To create a link by using DAO, use the Connect property for the TableDef object.