Bookmark.InsertDatabase-Methode

Artikel
01/03/2014

Ruft Daten aus einer Datenquelle ab (z. B. einem separaten Microsoft Office Word-Dokument, einem Microsoft Office Excel-Arbeitsblatt oder einer Microsoft Access Datenbank) und fügt die Daten als Tabelle an der Position des Bookmark-Steuerelements ein.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
Sub InsertDatabase ( _
    ByRef Format As Object, _
    ByRef Style As Object, _
    ByRef LinkToSource As Object, _
    ByRef Connection As Object, _
    ByRef SQLStatement As Object, _
    ByRef SQLStatement1 As Object, _
    ByRef PasswordDocument As Object, _
    ByRef PasswordTemplate As Object, _
    ByRef WritePasswordDocument As Object, _
    ByRef WritePasswordTemplate As Object, _
    ByRef DataSource As Object, _
    ByRef From As Object, _
    ByRef To As Object, _
    ByRef IncludeFields As Object _
)

void InsertDatabase(
    ref Object Format,
    ref Object Style,
    ref Object LinkToSource,
    ref Object Connection,
    ref Object SQLStatement,
    ref Object SQLStatement1,
    ref Object PasswordDocument,
    ref Object PasswordTemplate,
    ref Object WritePasswordDocument,
    ref Object WritePasswordTemplate,
    ref Object DataSource,
    ref Object From,
    ref Object To,
    ref Object IncludeFields
)

Parameter

Format
Typ: System.Object%
Ein im Dialogfeld AutoFormat für Tabelle im Feld Formate aufgelistetes Format.Kann eine der WdTableFormat-Konstanten sein.Für die Zellen in der Tabelle wird standardmäßig ein Rahmen eingefügt.

Style
Typ: System.Object%
Die von Format angegebenen Attribute von AutoFormat, die auf die Tabelle angewendet werden.Verwenden Sie die Summe aus einer beliebigen Kombination der folgenden Werte:
[1|1] Wert
[1|2] Bedeutung
[2|1] 0 (null)
[2|2] Keine
[3|1] 1
[3|2] Rahmen
[4|1] 2
[4|2] Schattierung
[5|1] 4
[5|2] Schriftart
[6|1] 8
[6|2] Farbe
[7|1] 16
[7|2] Automatisch anpassen
[8|1] 32
[8|2] Überschriftszeilen
[9|1] 64
[9|2] Letzte Zeile
[10|1] 128
[10|2] Erste Spalte
[11|1] 256
[11|2] Letzte Spalte

LinkToSource
Typ: System.Object%
true, um einen Link zwischen der neuen Tabelle und der Datenquelle zu erstellen.

Connection
Typ: System.Object%
Ein Bereich, in dem die von SQLStatement angegebene Abfrage ausgeführt wird.Wie Sie den Bereich angeben, hängt davon ab, wie Daten abgerufen werden.Beispiel:
Wenn Sie Daten mit ODBC (Open Database Connectivity) abrufen, geben Sie eine Verbindungszeichenfolge an.
Wenn Sie Daten mit DDE (Dynamic Data Exchange) aus Microsoft Office Excel abrufen, geben Sie einen benannten Bereich oder "Gesamtes Tabellenblatt" an.
Hinweis DDE (Dynamic Data Exchange) ist eine ältere Technologie, die nicht sicher ist.Verwenden Sie ggf. eine sicherere Alternative zu DDE, z. B. OLE (Object Linking and Embedding).
Wenn Sie Daten aus Microsoft Access abrufen, geben Sie das Wort "Tabelle" oder "Abfrage" und dahinter den Namen der Tabelle oder der Abfrage an.

SQLStatement
Typ: System.Object%
Eine optionale Abfragezeichenfolge, die eine Teilmenge der Daten in einer primären Datenquelle abruft, die in ein Dokument eingefügt werden soll.

SQLStatement1
Typ: System.Object%
Wenn die Abfragezeichenfolge mehr als 255 Zeichen enthält, kennzeichnet SQLStatement den ersten und SQLStatement1 den zweiten Teil der Zeichenfolge.

PasswordDocument
Typ: System.Object%
Das (ggf.) zum Öffnen der Zeichenfolge erforderliche Kennwort. (Siehe Hinweise unten.)

PasswordTemplate
Typ: System.Object%
Wenn die Datenquelle ein Microsoft Office Word-Dokument ist, ist dieses Argument das zum Öffnen der angehängten Vorlagen ggf. erforderliche Kennwort. (Siehe Hinweise unten.)

WritePasswordDocument
Typ: System.Object%
Das zum Speichern von Änderungen im Dokument erforderliche Kennwort. (Siehe Hinweise unten.)

WritePasswordTemplate
Typ: System.Object%
Das zum Speichern von Änderungen in der Vorlage erforderliche Kennwort. (Siehe Hinweise unten.)

DataSource
Typ: System.Object%
Der Pfad und der Dateiname der Datenquelle.

From
Typ: System.Object%
Die einzufügende Nummer des ersten Datensatzes im Datensatzbereich.

To
Typ: System.Object%
Die einzufügende Nummer des letzten Datensatzes im Datensatzbereich.

IncludeFields
Typ: System.Object%
true, um Feldnamen aus der Datenquelle in der ersten Zeile der neuen Tabelle einzuschließen.

Hinweise

Verwenden Sie in Anwendungen keine hartcodierten Kennwörter. Wenn in einer Prozedur ein Kennwort erforderlich ist, fordern Sie es vom Benutzer an, speichern Sie es in einer Variablen, und verwenden Sie anschließend die Variable im Code.

Verwenden Sie das integrierte Systemadministrator-Anmeldekonto (sa) nicht. Weisen Sie Systemadministratoren stattdessen die feste Sysadmin-Serverrolle zu, und lassen Sie sie als Member eigene Anmeldekonten verwenden. Verwenden Sie das sa-Konto nur, wenn keine andere Möglichkeit zum Anmelden besteht. Um unbefugten Zugriff über das sa-Anmeldekonto zu verhindern, sollten Sie diesem Konto ein sicheres, eindeutiges Kennwort zuordnen.

Wenn möglich, verwenden Sie Windows Authentication (auch bekannt als vertrauenswürdige Verbindung), wobei ein Windows-Benutzerkonto für die Verbindung zu SQL Server verwendet wird. Wenn ein Benutzer über ein Windows-Benutzerkonto eine Verbindung herstellt, verwendet SQL Server Informationen im Windows-Betriebssystem, um Kontonamen und Kennwort zu überprüfen. Bevor Sie Windows Authentication verwenden können, muss ein Serveradministrator SQL Server für die Verwendung dieses Authentifizierungsmodus konfigurieren. Wenn Windows Authentication nicht verfügbar ist, sollten Sie Anmeldeinformationen von Benutzern nicht speichern. Es ist sicherer, wenn Benutzer bei jeder Anmeldung ihre Anmeldeinformationen eingeben.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

In diesem Beispiel wird ein Microsoft Excel-Arbeitsblatt in das Bookmark-Steuerelement eingefügt. Der Style-Wert (191) ist eine Kombination der Zahlen 1, 2, 4, 8, 16, 32 und 128. In diesem Beispiel wird davon ausgegangen, dass Sie über eine im Laufwerk C:\ gespeicherte Arbeitsmappe mit dem Namen Data.xlsx verfügen, in der auf dem Arbeitsblatt mindestens zwei Zeilen mit Daten gefüllt sind.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub BookmarkInsertDatabase()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.Text = "This is sample bookmark text"
    Bookmark1.InsertDatabase(Format:=Word.WdTableFormat _
        .wdTableFormatClassic1, Style:=191, LinkToSource:=False, _
        Connection:="Entire Spreadsheet", DataSource:="C:\Data.xlsx")

End Sub

private void BookmarkInsertDatabase()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text";

    object Format = Word.WdTableFormat.wdTableFormatClassic1;
    object Style = 191;
    object LinkToSource = false;
    object Connection = "Entire Spreadsheet";
    object DataSource = "C:\\Data.xlsx";

    bookmark1.InsertDatabase(ref Format, ref Style, ref LinkToSource,
        ref Connection, ref missing, ref missing, ref missing,
        ref missing, ref missing, ref missing, ref DataSource,
        ref missing, ref missing, ref missing);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Bookmark Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über