Range.InsertDatabase-Methode (Word)

  • Artikel

Ruft Daten aus einer Datenquelle ab (z. B. ein separates Microsoft Word-Dokument, ein Microsoft Excel-Arbeitsblatt oder eine Microsoft Access-Datenbank) und fügt die Daten als Tabelle anstelle des angegebenen Bereichs ein.

Syntax

Ausdruck. InsertDatabase (Format, Style, LinkToSource, Connection, SQLStatement, SQLStatement1, PasswordDocument, PasswordTemplate, WritePasswordDocument, WritePasswordTemplate, DataSource, From, To, IncludeFields)

Ausdruck: Erforderlich. Eine Variable, die ein Range -Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Format Optional Variant Ein Format, das im Dialogfeld Tabelle AutoFormat (Menü Tabelle) im Feld Formate aufgelistet ist. Dabei kann es sich um eine der WdTableFormat-Konstanten handeln. Den Zellen in der Tabelle wird standardmäßig ein Rahmen zugewiesen.
Style Optional Variant Die Attribute des durch Format angegebenen AutoFormats, die der Tabelle zugewiesen werden.
LinkToSource Optional Variant True, wenn eine Verknüpfung zwischen der neuen Tabelle und der Datenquelle hergestellt werden soll.
Connection Optional Variant Ein Bereich, in dem die Abfrage ausgeführt werden soll, die durch SQLStatement angegeben wird.
SQLStatement Optional String Eine optionale Abfragezeichenfolge, die eine Untermenge der Daten in einer primären Datenquelle abruft, die in das Dokument eingefügt werden sollen.
SQLStatement1 Optional String Bei Abfragezeichenfolgen mit mehr als 255 Zeichen bestimmen Sie mit SQLStatement den ersten Teil der Zeichenfolge und mit SQLStatement1 den zweiten.
PasswordDocument Optional Variant Das gegebenenfalls zum Öffnen der Datenquelle erforderliche Kennwort. (Weitere Informationen finden Sie unten in den Hinweisen.)
PasswordTemplate Optional Variant Wenn es sich bei der Datenquelle um ein Word-Dokument handelt, ist dieses Argument das Kennwort, das gegebenenfalls zum Öffnen der zugewiesenen Vorlage benötigt wird. (Weitere Informationen finden Sie unten in den Hinweisen.)
WritePasswordDocument Optional Variant Das zum Speichern von Änderungen am Dokument erforderliche Kennwort. (Weitere Informationen finden Sie unten in den Hinweisen.)
WritePasswordTemplate Optional Variant Das zum Speichern von Änderungen an der Vorlage erforderliche Kennwort. (Weitere Informationen finden Sie unten in den Hinweisen.)
DataSource Optional Variant Der Pfad und der Dateiname der neuen Datenquelle.
From Optional Variant Die Nummer des ersten Datensatzes im Bereich der einzufügenden Datensätze.
Bis Optional Variant Die Nummer des letzten Datensatzes im Bereich der einzufügenden Datensätze.
IncludeFields Optional Variant True, wenn Feldnamen aus der Datenquelle in die erste Zeile der neuen Tabelle aufgenommen werden sollen.

Sicherheit

Wichtig

Vermeiden Sie das Verwenden von hartcodierten Kennwörtern in Anwendungen. Fordern Sie das Kennwort vom Benutzer an, speichern Sie es in einer Variablen, und verwenden Sie die Variable dann im Code, falls ein Kennwort in einer Prozedur benötigt wird. Empfohlene bewährte Methoden hierzu finden Sie unter Sicherheitshinweise für Entwickler von Office-Lösungen.

HinwBemerkungeneise

Der Wert des Arguments Style kann der Summe einer beliebigen Kombination der folgenden Werte entsprechen:

Wert Beschreibung
0 (null) Keine
1 Rahmen
2 Schattierung
4 Schriftart
8 Farbe
16 Automatisch anpassen
32 Überschriftenzeilen
64 Letzte Zeile
128 Erste Spalte
256 Letzte Spalte

Die Art und Weise, wie Sie das Argument Connection angeben, ist davon abhängig, wie die Daten abgerufen werden. Beispiel:

  • Beim Datenabruf über Open Database Connectivity (ODBC) legen Sie eine Verbindungszeichenfolge fest.

  • Beim Abrufen von Daten aus Excel mithilfe des dynamischen Datenaustauschs (Dynamic Data Exchange, DDE) geben Sie einen benannten Bereich oder "Gesamtes Arbeitsblatt" an.

  • Wenn Sie Daten aus Access abrufen, verwenden Sie die Begriffe "Tabelle" oder "Abfrage" gefolgt vom Namen der Tabelle bzw. Abfrage.

Beispiel

In diesem Beispiel wird eine Excel-Kalkulationstabelle Data.xls nach der Markierung eingefügt. Der Style-Wert (191) ist eine Kombination der Zahlen 1, 2, 4, 8, 16, 32 und 128.

With Selection 
    .Collapse Direction:=wdCollapseEnd 
    .Range.InsertDatabase _ 
        Format:=wdTableFormatSimple2, Style:=191, _ 
        LinkToSource:=False, Connection:="Entire Spreadsheet", _ 
        DataSource:="C:\MSOffice\Excel\Data.xls" 
End With

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.