Bookmark.InsertDatabase(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) Methode
Definition
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);
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
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
- Object
true, um einen Link zwischen der neuen Tabelle und der Datenquelle zu erstellen.
- Connection
- 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. Zum 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
- 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 mehr als 255 Zeichen enthält, kennzeichnet SQLStatement den ersten und SQLStatement1 den zweiten Teil der Zeichenfolge.
- 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 eine Microsoft Excel-Tabelle in das-Steuerelement eingefügt Bookmark . Der Stilwert (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 im Stamm Data.xlsx Verzeichnis des C-Verzeichnisses mit mindestens zwei Daten Zeilen im Arbeitsblatt gespeichert ist.
Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.
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 von hart codierten Kenn Wörtern in Ihren Anwendungen. Wenn ein Kennwort in einer Prozedur erforderlich ist, fordern Sie das Kennwort des Benutzers an, speichern Sie es in einer Variablen, und verwenden Sie dann die Variable im Code.
Vermeiden Sie die Verwendung des integrierten Systemadministrator-Anmelde Kontos (SA). Nehmen Sie stattdessen Systemadministratoren Mitglieder der festen Server Rolle sysadmin, und verwenden Sie Ihre eigenen Konten, um sich anzumelden. Verwenden Sie SA nur, wenn keine andere Möglichkeit zum Anmelden vorhanden ist. Um nicht autorisierten Zugriff über das SA-Anmelde Konto 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 Server Administrator SQL Server konfigurieren, um diesen Authentifizierungsmodus zu verwenden. Wenn die Windows-Authentifizierung nicht verfügbar ist, sollten Sie die Anmelde Informationen des Benutzers nicht speichern. Es ist sicherer, dass Benutzer ihre Anmelde Informationen bei jeder Anmeldung eingeben.
Optionale Parameter
Weitere Informationen zu optionalen Parametern finden Sie unter optionale Parameter in Office-Projektmappen.