Bookmark.InsertDatabase 方法

參考

定義

命名空間:: Microsoft.Office.Tools.Word

組件:: Microsoft.Office.Tools.Word.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

從資料來源 (例如：不同的 Microsoft Office Word 文件、Microsoft Office Excel 工作表，或 Microsoft Access 資料庫) 擷取資料，然後將資料當做表格插入以取代 Bookmark 控制項。

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)

參數

Format: Object

列在 [表格自動格式設定] 對話方塊 [格式] 方塊中的格式。可以是其中任何一個 WdTableFormat 常數。根據預設，框線會套用至表格的儲存格中。

Style: Object

套用至數據表之所 Format 指定之 AutoFormat 的屬性。使用下列值的任何組合總和：[1|1] Value[1|2] Meaning[2|1] 0 (零) [2|2] None[3|1] 1[3|2] Borders[4|1] 2[4|2] Shading[5|1] 4[5]4[5|2] 字型[6|1] 8[6|2] 色彩[7|1] 16[7|2] 自動調整[8|1] 32[8|2] 標題列[9|1] 64[9|2] 最後一列[10|1] 128[10|2]第一欄[11|1] 256[11|2] 最後一欄

LinkToSource: Object

若要建立新表格和資料來源之間的連結，則為 true。

Connection: Object

要在其中執行所 SQLStatement指定查詢的範圍。指定範圍的方法是依據擷取資料的方式而定。例如：透過Open Database Connectivity (ODBC) 擷取數據時，您會指定連接字串。使用動態數據交換 (DDE) 從 Microsoft Office Excel 擷取數據時，您可以指定具名範圍或「整個電子錶格」。注意動態數據交換 (DDE) 是不安全的較舊技術。可能的話，請使用更安全的 DDE 替代方案，例如對象連結和內嵌 (OLE) 。從 Microsoft Access 擷取數據時，您可以指定「Table」或「Query」這個字，後面接著數據表或查詢的名稱。

SQLStatement: Object

選擇性的查詢字串會在主要資料來源中擷取希望插入文件的資料子集。

SQLStatement1: Object

如果查詢字串超過 255 個字元， SQLStatement 表示字串的第一個部分，並 SQLStatement1 表示第二個部分。

PasswordDocument: Object

開啟資料來源所需要的密碼 (若有的話)。請參閱下方註解。

PasswordTemplate: Object

如果資料來源是 Microsoft Office Word 文件，這個引數便是開啟附加範本所需要的密碼 (若有的話)。請參閱下方註解。

WritePasswordDocument: Object

將變更儲存至文件所需要的密碼 (若有的話)。請參閱下方註解。

WritePasswordTemplate: Object

將變更儲存至範本所需要的密碼 (若有的話)。請參閱下方註解。

DataSource: Object

資料來源的路徑和檔案名稱。

From: Object

資料錄範圍中所要插入的第一筆資料錄編號。

To: Object

資料錄範圍中所要插入的最後一筆資料錄編號。

IncludeFields: Object

若要在新資料表的第一列中包含得自資料來源的檔案名稱，則為 true。

範例

本範例會在控件中 Bookmark 插入 Microsoft Excel 電子表格。 Style 值 (191) 是數位 1、2、4、8、16、32 和 128 的組合。本範例假設您有一個名為的 Data.xlsx 活頁簿儲存至 C 目錄的根目錄，且工作表上至少有兩列數據。

此範例適用於檔層級自定義。

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

備註

避免在應用程式中使用硬式編碼密碼。如果程式中需要密碼，請向使用者要求密碼、將其儲存在變數中，然後在您的程式代碼中使用變數。

避免使用內建的系統管理員 (sa) 登入帳戶。相反地，讓系統管理員成為系統管理員固定伺服器角色的成員，並讓他們使用自己的帳戶登入。只有在沒有其他方式可登入時，才使用 sa。若要防止未經授權的透過sa登入帳戶進行存取，您應該將該帳戶指派為強式唯一密碼。

可能的話，請使用 Windows 驗證 (也稱為信任的連線) ，這會使用 Windows 使用者帳戶來連線到 SQL Server。當使用者透過 Windows 使用者帳戶連線時，SQL Server 會使用 Windows 作業系統中的資訊來驗證帳戶名稱和密碼。使用 Windows 驗證之前，伺服器管理員必須先設定 SQL Server 使用此驗證模式。如果無法使用 Windows 驗證，請避免儲存使用者的登入資訊。當使用者每次登入時，輸入登入資訊會更安全。

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。

適用於

Bookmark.InsertDatabase 方法

定義

參數

範例

備註

選擇性參數

適用於

其他資源