Bookmark.InsertDatabase Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Word

Zestaw:: Microsoft.Office.Tools.Word.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera dane ze źródła danych (na przykład oddzielny dokument pakietu Microsoft Office Word, arkusz programu Microsoft Office Excel lub bazę danych programu Microsoft Access) i wstawia dane jako tabelę zamiast kontrolkiBookmark.

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)

Parametry

Format: Object

Format wymieniony w polu Formaty w oknie dialogowym Autoformatowanie tabeli. Może to być dowolna ze WdTableFormat stałych. Obramowanie jest domyślnie stosowane do komórek w tabeli.

Style: Object

Atrybuty autoformatowania określone przez Format te atrybuty są stosowane do tabeli. Użyj sumy dowolnej kombinacji następujących wartości:[1|1] Wartość[1|2] Znaczenie[2|1] 0 (zero)[2|2] Brak[3|1] 1[3|2] Obramowania[4|1] 2[4|2] Cieniowanie[5|1] 4[5|2] 4[5|2] Czcionka[6|1] 8[6|2] Kolor[7|1] 16[7|2] Automatyczne dopasowanie[8|1] 32[8|2] Wiersze nagłówka[9|1] 64[9|2] Ostatni wiersz[10|1] 128[10|2] Pierwsza kolumna[ 11|1] 256[11|2] Ostatnia kolumna

LinkToSource: Object

true aby ustanowić połączenie między nową tabelą a źródłem danych.

Connection: Object

Zakres, w którym ma być wykonywane zapytanie określone przez SQLStatement. Sposób określania zakresu zależy od sposobu pobierania danych. Na przykład: podczas pobierania danych za pomocą funkcji Łączności z otwartą bazą danych (ODBC) należy określić parametry połączenia. Podczas pobierania danych z programu Microsoft Office Excel przy użyciu dynamicznej wymiany danych (DDE) należy określić nazwany zakres lub "Cały arkusz kalkulacyjny". Uwaga Dynamiczna wymiana danych (DDE) to starsza technologia, która nie jest bezpieczna. Jeśli to możliwe, użyj bezpieczniejszej alternatywy dla funkcji DDE, takiej jak łączenie obiektów i osadzanie (OLE). Podczas pobierania danych z programu Microsoft Access należy określić słowo "Tabela" lub "Zapytanie", po którym następuje nazwa tabeli lub zapytania.

SQLStatement: Object

Opcjonalny ciąg zapytania, który pobiera podzestaw danych w podstawowym źródle danych, który ma zostać wstawiony do dokumentu.

SQLStatement1: Object

Jeśli ciąg zapytania jest dłuższy niż 255 znaków, SQLStatement oznacza pierwszą część ciągu i SQLStatement1 oznacza drugą część.

PasswordDocument: Object

Hasło (jeśli istnieje) wymagane do otwarcia źródła danych. (Zobacz uwagi poniżej).

PasswordTemplate: Object

Jeśli źródłem danych jest dokument Word pakietu Microsoft Office, ten argument jest hasłem (jeśli istnieje) wymaganym do otwarcia dołączonego szablonu. (Zobacz uwagi poniżej).

WritePasswordDocument: Object

Hasło wymagane do zapisania zmian w dokumencie. (Zobacz uwagi poniżej).

WritePasswordTemplate: Object

Hasło wymagane do zapisania zmian w szablonie. (Zobacz uwagi poniżej).

DataSource: Object

Ścieżka i nazwa pliku źródła danych.

From: Object

Liczba pierwszego rekordu danych w zakresie rekordów do wstawienia.

To: Object

Liczba ostatnich rekordów danych w zakresie rekordów do wstawienia.

IncludeFields: Object

true w celu uwzględnienia nazw pól ze źródła danych w pierwszym wierszu nowej tabeli.

Przykłady

Ten przykład wstawia arkusz kalkulacyjny programu Microsoft Excel do kontrolki Bookmark . Wartość stylu (191) jest kombinacją liczb 1, 2, 4, 8, 16, 32 i 128. W tym przykładzie założono, że masz skoroszyt o nazwie Data.xlsx zapisany w katalogu głównym katalogu C z co najmniej dwoma wierszami danych w arkuszu.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

Unikaj używania haseł z góry ustalonych w aplikacjach. Jeśli hasło jest wymagane w procedurze, należy zażądać hasła od użytkownika, zachować je w zmiennej, a następnie użyć zmiennej w kodzie.

Unikaj korzystania z wbudowanego konta logowania administratora systemu (sa). Zamiast tego należy dodawać administratorów systemu do stałej roli serwera sysadmin i używać własnych kont do logowania. Użyj sa tylko wtedy, gdy nie ma innego sposobu logowania. Aby zapobiec nieautoryzowanemu dostępowi za pośrednictwem konta logowania sa, należy przypisać to konto jako silne, unikatowe hasło.

Jeśli to możliwe, użyj uwierzytelniania systemu Windows (nazywanego również zaufanym połączeniem), który używa konta użytkownika systemu Windows do nawiązywania połączenia z SQL Server. Gdy użytkownik łączy się za pośrednictwem konta użytkownika systemu Windows, SQL Server używa informacji w systemie operacyjnym Windows w celu zweryfikowania nazwy konta i hasła. Aby można było użyć uwierzytelniania systemu Windows, administrator serwera musi skonfigurować SQL Server do korzystania z tego trybu uwierzytelniania. Jeśli uwierzytelnianie systemu Windows jest niedostępne, unikaj zapisywania informacji logowania użytkowników. Za każdym razem, gdy logują się, użytkownicy będą mogli wprowadzać informacje logowania.

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.

Dotyczy

Udostępnij za pośrednictwem