DoCmd.TransferText-Methode (Access)DoCmd.TransferText method (Access)

Mit der TransferText-Methode wird die "TransferText"-Aktion in Visual Basic ausgeführt.The TransferText method carries out the TransferText action in Visual Basic.

SyntaxSyntax

expression.TransferText (TransferType, SpecificationName, TableName, FileName, HasFieldNames, HTMLTableName, CodePage)expression.TransferText (TransferType, SpecificationName, TableName, FileName, HasFieldNames, HTMLTableName, CodePage)

expression Eine Variable, die ein DoCmd-Objekt darstellt.expression A variable that represents a DoCmd object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
TransferTypeTransferType OptionalOptional AcTextTransferTypeAcTextTransferType Der Typ des gewünschten Transfers.The type of transfer you want to make. Importieren von Daten aus, Exportieren von Daten nach oder Verknüpfen mit Daten in Dateien mit Trennzeichen, Textdateien mit fester Breite oder HTML-Dateien ist möglich.You can import data from, export data to, or link to data in delimited or fixed-width text files or HTML files. Der Standardwert lautet acImportDelim.The default value is acImportDelim. Es werden nur die Transfertypen acImportDelim, acImportFixed, acExportDelim, acExportFixed oder acExportMerge in einem Microsoft Access-Projekt (ADP) unterstützt.Only acImportDelim, acImportFixed, acExportDelim, acExportFixed, or acExportMerge transfer types are supported in a Microsoft Access project (.adp).
SpecificationNameSpecificationName OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der den Namen einer Import- oder Exportspezifikation angibt, die Sie in der aktuellen Datenbank erstellt und gespeichert haben.A string expression that's the name of an import or export specification you've created and saved in the current database. Bei einer Textdatei mit fester Zeilenlänge müssen Sie entweder ein Argument angeben oder eine Schemadatei (Schema.ini) verwenden, die in demselben Ordner wie die importierte, verknüpfte oder exportierte Textdatei gespeichert sein muss.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.

Zur Erstellung einer Schemadatei können Sie den Import/Export-Assistenten für Text verwenden.To create a schema file, you can use the text import/export wizard to create the file. Bei Textdateien mit Trennzeichen und Microsoft Word-Seriendruck-Datendateien können Sie dieses Argument auslassen, um so die Standardimport- und -exportspezifikation auszuwählen.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 OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der den Namen einer Access-Tabelle zum Importieren, Exportieren oder Verknüpfen von Textdaten angibt, oder die Access-Abfrage, deren Ergebnisse in eine Textdatei exportiert werden sollen.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 OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der den vollständigen Namen und den Pfad der Textdatei angibt, die zum Importieren, Exportieren oder Verknüpfen von Daten verwendet werden soll.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 OptionalOptional VariantVariant Verwenden Sie True (1), um die erste Zeile der Textdatei beim Importieren, Exportieren oder Verknüpfen zur Angabe der Feldnamen zu verwenden.Use True (1) to use the first row of the text file as field names when importing, exporting, or linking. Verwenden Sie False (0), um die erste Zeile der Textdatei als normale Daten zu behandeln.Use False (0) to treat the first row of the text file as normal data. Wenn Sie dieses Argument leer lassen, wird der Standard (False) angenommen.If you leave this argument blank, the default (False) is assumed. Dieses Argument wird für Seriendruck-Dateiendateien in Microsoft Word ignoriert, die die Feldnamen immer in der ersten Zeile enthalten müssen.This argument is ignored for Microsoft Word mail merge data files, which must always contain the field names in the first row.
HTMLTableNameHTMLTableName OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der den Namen der Tabelle oder Liste in der HTML-Datei angibt, die Sie importieren oder verknüpfen möchten.A string expression that's the name of the table or list in the HTML file that you want to import or link. Dieses Argument wird ignoriert, es sei denn, das TransferType-Argument wird auf acImportHTML oder acLinkHTML festgelegt.This argument is ignored unless the TransferType argument is set to acImportHTML or acLinkHTML. Wenn Sie dieses Argument leer lassen, wird die erste Tabelle oder Liste in der HTML-Datei importiert oder verknüpft.If you leave this argument blank, the first table or list in the HTML file is imported or linked.

Der Name der Tabelle oder Liste in der HTML-Datei wird durch den vom CAPTION-Tag angegebenen Text angegeben, wenn ein CAPTION-Tag vorhanden ist.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. Wenn kein CAPTION -Tag vorhanden ist, wird der Name durch den vom TITLE-Tag angegebenen Text bestimmt.If there's no CAPTION tag, the name is determined by the text specified by the TITLE tag. Wenn mehrere Tabellen oder Listen denselben Namen aufweisen, unterscheidet Access diese, indem am Ende jedes Tabellen- oder Listennamens eine Zahl hinzugefügt wird, z. B. Mitarbeiter1 und Mitarbeiter2.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.
CodePage-BezeichnerCodePage Identifiers OptionalOptional VariantVariant Ein Wert vom Typ Long, der den Zeichensatz der Codepage angibt.A Long value indicating the character set of the code page.

BemerkungenRemarks

Sie können die TransferText-Methode verwenden, um Text zwischen der aktuellen Access-Datenbank oder dem aktuellen Access-Projekt (ADP) und einer Textdatei zu importieren oder zu exportieren.You can use the TransferText method to import or export text between the current Access database or Access project (.adp) and a text file. Sie können die Daten in einer Textdatei auch mit der aktuellen Access-Datenbank verknüpfen.You can also link the data in a text file to the current Access database. Mit einer verknüpften Textdatei können Sie die Textdaten mit Access anzeigen, während Sie weiterhin in Ihrem Textverarbeitungsprogramm vollständigen Zugriff auf die Daten haben.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. Importieren aus, Exportieren in und Verknüpfen mit können Sie auch für eine Tabelle oder Liste in einer HTML-Datei (*.html) ausführen.You can also import from, export to, and link to a table or list in an HTML file (*.html).

Sie können die Daten aus Access-Auswahlabfragen in Textdateien exportieren.You can export the data in Access select queries to text files. In Access wird das Resultset der Abfrage exportiert, wo es wie eine Tabelle behandelt wird.Access exports the result set of the query, treating it just like a table.

BeispielExample

Dieses Beispiel exportiert die Daten aus der Access-Tabelle "Externer Bericht" in die durch Trennzeichen getrennte Textdatei "April.doc" unter Verwendung der Spezifikation Standardausgabe.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"

Im folgenden Code wird gezeigt, wie ein neues Microsoft Word-Dokument erstellt und ein Seriendruck mit in der Tabelle Kunden enthaltenen Daten ausgeführt wird.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 und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.