Метод DoCmd.TransferText (Access)DoCmd.TransferText method (Access)

Метод TransferText выполняет действие TransferText в Visual Basic.The TransferText method carries out the TransferText action in Visual Basic.

СинтаксисSyntax

выражение.TransferText (TransferType, SpecificationName, TableName, FileName, HasFieldNames, HTMLTableName, CodePage)expression.TransferText (TransferType, SpecificationName, TableName, FileName, HasFieldNames, HTMLTableName, CodePage)

выражение: переменная, представляющая объект DoCmd.expression A variable that represents a DoCmd object.

ПараметрыParameters

ИмяName Обязательный или необязательныйRequired/Optional Тип данныхData type ОписаниеDescription
TransferTypeTransferType НеобязательныйOptional AcTextTransferTypeAcTextTransferType Нужный тип преобразования.The type of transfer you want to make. Вы можете импортировать данные из текстовых или HTML-файлов с разделителями или полями фиксированного размера, экспортировать их в такие файлы или создать ссылку на них.You can import data from, export data to, or link to data in delimited or fixed-width text files or HTML files. Значение по умолчанию — acImportDelim.The default value is acImportDelim. В проекте Microsoft Access (ADP) поддерживаются только типы передаваемых данных acImportDelim, acImportFixed, acExportDelim, acExportFixed и acExportMerge.Only acImportDelim, acImportFixed, acExportDelim, acExportFixed, or acExportMerge transfer types are supported in a Microsoft Access project (.adp).
SpecificationNameSpecificationName НеобязательныйOptional VariantVariant Строковое выражение, которое является именем спецификации импорта или экспорта, созданной и сохраненной в текущей базе данных. A string expression that's the name of an import or export specification you've created and saved in the current database. Для текстового файла с полями фиксированного размера необходимо указать аргумент или использовать файл schema.ini, который должен находиться в той же папке, что и импортируемый, связываемый или экспортируемый текстовый файл.For a fixed-width text file, you must either specify an argument or use a schema.ini file, which must be stored in the same folder as the imported, linked, or exported text file.

Чтобы создать файл схемы, можно использовать мастер импорта и экспорта текста для создания файла.To create a schema file, you can use the text import/export wizard to create the file. Для текстовых файлов с разделителями и файлов данных слияния Microsoft Word можно оставить этот аргумент пустым для выбора спецификаций по умолчанию для импорта и экспорта.For delimited text files and Microsoft Word mail merge data files, you can leave this argument blank to select the default import/export specifications.
TableNameTableName НеобязательныйOptional VariantVariant Строковое выражение, являющееся именем таблицы Access для импорта, экспорта или связывания текстовых данных, либо запрос Access, результаты которого нужно экспортировать в текстовый файл.A string expression that's the name of the Access table you want to import text data to, export text data from, or link text data to, or the Access query whose results you want to export to a text file.
FileNameFileName НеобязательныйOptional VariantVariant Строковое выражение, являющееся полным именем (включая путь) текстового файла для импорта, экспорта или связывания.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.
HasFieldNamesHasFieldNames НеобязательныйOptional VariantVariant Используйте значение True (1), чтобы использовать первую строку текстового файла в качестве имен полей при импорте, экспорте или связывании.Use True (1) to use the first row of the text file as field names when importing, exporting, or linking. Используйте значение False (0), чтобы считать первую строку текстового файла обычными данными. Use False (0) to treat the first row of the text file as normal data. Если оставить этот аргумент пустым, предполагается, что используется значение по умолчанию (False).If you leave this argument blank, the default (False) is assumed. Этот аргумент игнорируется для файлов данных слияния Microsoft Word, которые всегда должны содержать имена полей в первой строке.This argument is ignored for Microsoft Word mail merge data files, which must always contain the field names in the first row.
HTMLTableNameHTMLTableName НеобязательныйOptional VariantVariant Строковое выражение, являющееся именем таблицы (или списка) в HTML-файле, которую необходимо импортировать или связать.A string expression that's the name of the table or list in the HTML file that you want to import or link. Этот аргумент игнорируется, если для аргумента TransferType не выбрано значение acImportHTML или acLinkHTML.This argument is ignored unless the TransferType argument is set to acImportHTML or acLinkHTML. Если данный аргумент не задан, импортируется или связывается первая таблица или список в HTML-файле.If you leave this argument blank, the first table or list in the HTML file is imported or linked.

Имя таблицы или списка в HTML-файле определяется по тексту, который указан тегом CAPTION, если такой тег существует.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. Если тега CAPTION нет, имя определяется по тексту с тегом TITLE.If there's no CAPTION tag, the name is determined by the text specified by the TITLE tag. Если несколько таблиц или списков имеют одно и то же имя, Access различает их, добавляя число в конец каждого имени таблицы или списка (например, "Сотрудники1" и "Сотрудники2").If more than one table or list has the same name, Access distinguishes them by adding a number to the end of each table or list name; for example, Employees1 and Employees2.
Идентификаторы CodePageCodePage Identifiers НеобязательныйOptional VariantVariant Значение Long, указывающее кодировку кодовой страницы.A Long value indicating the character set of the code page.

ПримечанияRemarks

Метод TransferText можно использовать для импорта или экспорта текста между текущей базой данных Access или проектом Access (ADP) и текстовым файлом.You can use the TransferText method to import or export text between the current Access database or Access project (.adp) and a text file. Вы также можете связать данные в текстовом файле с текущей базой данных Access.You can also link the data in a text file to the current Access database. Это позволит просматривать текстовые файлы через Access, при этом не теряя возможность работы с ними в текстовом редакторе.With a linked text file, you can view the text data with Access while still allowing complete access to the data from your word processing program. Вы также можете выполнить импорт из таблицы или списка в HTML-файле, экспортировать данные в них или создать связь с ними.You can also import from, export to, and link to a table or list in an HTML file (*.html).

Вы можете экспортировать данные запросов на выборку Access в текстовые файлы.You can export the data in Access select queries to text files. Access экспортирует результирующий набор запроса так же, как таблицу.Access exports the result set of the query, treating it just like a table.

ПримерExample

В следующем примере данные из внешнего отчета из таблицы Access экспортируются в текстовый файл с разделителями April.doc с использованием стандартного вывода спецификации.The following example exports the data from the Access table External Report to the delimited text file April.doc by using the specification Standard Output.

DoCmd.TransferText acExportDelim, "Standard Output", _ 
    "External Report", "C:\Txtfiles\April.doc"

В следующем примере коде показано, как создать новый документ Microsoft Word и выполнить слияние с данными, хранящимися в таблице Customers (Клиенты).The following code shows how to create a new Microsoft Word document and perform a mail merge with the data stored in the Customers table.

Public Sub DoMailMerge(strFileSavePath As String)

    ' Create new Word App, add a document and set it visible
    Dim wdApp As New Word.Application
    wdApp.Documents.Add
    wdApp.Visible = True

    ' Open the data set from this database
    wdApp.ActiveDocument.MailMerge.OpenDataSource _
        Name:=Application.CurrentProject.FullName, _
        OpenExclusive:=False, _
        LinkToSource:=True, _
        Connection:="TABLE Customers", _
        SQLStatement:="SELECT Customers.* FROM Customers;"
              
    ' Add fields to the mail merge document
    Dim oSel As Object
    Set oSel = wdApp.Selection
    With wdApp.ActiveDocument.MailMerge.Fields
    
        oSel.TypeText vbNewLine & vbNewLine
        .Add oSel.range, "First_Name"
        oSel.TypeText " "
        .Add oSel.range, "Last_Name"
        oSel.TypeText vbNewLine
        .Add oSel.range, "Company"
        oSel.TypeText vbNewLine
        .Add oSel.range, "Address"
        oSel.TypeText vbNewLine
        .Add oSel.range, "City"
        oSel.TypeText ", "
        .Add oSel.range, "State"
        oSel.TypeText " "
        .Add oSel.range, "Zip"
        oSel.TypeText vbNewLine
        oSel.TypeParagraph
        oSel.TypeText "Dear "
        .Add oSel.range, "First_Name"
        oSel.TypeText ","
        oSel.TypeText vbNewLine
        oSel.TypeParagraph
        oSel.TypeText "We have created this mail just for you..."
        oSel.TypeText vbNewLine
        oSel.TypeText vbNewLine
        oSel.TypeText "Sincerely," & vbNewLine & "John Q. Public"
        oSel.TypeText vbFormFeed
        
    End With
    
    ' Execute the mail merge and save the document
    wdApp.ActiveDocument.MailMerge.Execute
    wdApp.ActiveDocument.SaveAs strFileSavePath
        
    ' Close everything and Cleanup Variables
    Set oSel = Nothing
    wdApp.ActiveDocument.Close False
    Set wdApp = Nothing

End Sub

Поддержка и обратная связьSupport and feedback

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.