Bookmark.InsertDatabase Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

public 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);

abstract member InsertDatabase : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> unit

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

Parameter

Format: 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: Object

LinkToSource: Object

true, um einen Link zwischen der neuen Tabelle und der Datenquelle zu erstellen.

Connection: Object

Ein Bereich, in dem die durch angegebene Abfrage ausgeführt werden SQLStatementsoll. Wie Sie den Bereich angeben, hängt davon ab, wie Daten abgerufen werden. Beispiel:Beim Abrufen von Daten über Open Database Connectivity (ODBC) geben Sie eine Verbindungszeichenfolge an. Beim Abrufen von Daten aus Microsoft Office Excel mithilfe des dynamischen Datenaustauschs (DDE) geben Sie einen benannten Bereich oder "Gesamtes Arbeitsblatt" an. Hinweis Der dynamische Datenaustausch (DDE) ist eine ältere Technologie, die nicht sicher ist. Verwenden Sie nach Möglichkeit eine sicherere Alternative zu DDE, z. B. Objektverknüpfung und Einbettung (OLE). Beim Abrufen von Daten aus Microsoft Access geben Sie das Wort "Tabelle" oder "Abfrage" gefolgt vom Namen einer Tabelle oder Abfrage an.

SQLStatement: Object

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

SQLStatement1: Object

Wenn die Abfragezeichenfolge länger als 255 Zeichen ist, SQLStatement bezeichnet den ersten Teil der Zeichenfolge und SQLStatement1 den zweiten Teil.

PasswordDocument: Object

Das (ggf.) zum Öffnen der Zeichenfolge erforderliche Kennwort. (Siehe Hinweise unten.)

PasswordTemplate: 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: Object

Das zum Speichern von Änderungen im Dokument erforderliche Kennwort. (Siehe Hinweise unten.)

WritePasswordTemplate: Object

Das zum Speichern von Änderungen in der Vorlage erforderliche Kennwort. (Siehe Hinweise unten.)

DataSource: Object

Der Pfad und der Dateiname der Datenquelle.

From: Object

Die einzufügende Nummer des ersten Datensatzes im Datensatzbereich.

To: Object

Die einzufügende Nummer des letzten Datensatzes im Datensatzbereich.

IncludeFields: Object

true, um Feldnamen aus der Datenquelle in der ersten Zeile der neuen Tabelle einzuschließen.

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 Eine Arbeitsmappe mit dem Namen Data.xlsx im Stammverzeichnis C gespeichert ist und mindestens zwei Datenzeilen auf dem Arbeitsblatt enthalten sind.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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);
}

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

Hinweise

Vermeiden Sie die Verwendung hartcodierter Kennwörter in Ihren Anwendungen. Wenn in einer Prozedur ein Kennwort erforderlich ist, fordern Sie das Kennwort vom Benutzer an, speichern Sie es in einer Variablen, und verwenden Sie dann die Variable in Ihrem Code.

Vermeiden Sie die Verwendung des integrierten Systemadministratorkontos (sa). Machen Sie stattdessen Systemadministratoren mitglieder der festen Serverrolle sysadmin, und lassen Sie sie ihre eigenen Konten für die Anmeldung verwenden. Verwenden Sie sa nur, wenn es keine andere Möglichkeit zum Anmelden gibt. Um unbefugten Zugriff über das Sa-Anmeldekonto zu verhindern, sollten Sie diesem Konto ein sicheres, eindeutiges Kennwort zuweisen.

Verwenden Sie nach Möglichkeit die Windows-Authentifizierung (auch als vertrauenswürdige Verbindung bezeichnet), die ein Windows-Benutzerkonto verwendet, um eine Verbindung mit SQL Server herzustellen. Wenn ein Benutzer eine Verbindung über ein Windows-Benutzerkonto herstellt, verwendet SQL Server Informationen im Windows-Betriebssystem, um den Kontonamen und das Kennwort zu überprüfen. Bevor Sie die Windows-Authentifizierung verwenden können, muss ein Serveradministrator SQL Server konfigurieren, um diesen Authentifizierungsmodus zu verwenden. Wenn die Windows-Authentifizierung nicht verfügbar ist, vermeiden Sie das Speichern der Anmeldeinformationen von Benutzern. Es ist sicherer, dass Benutzer bei jeder Anmeldung ihre Anmeldeinformationen eingeben.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für: