共用方式為

Bookmark.InsertDatabase 方法

  • 發行項

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

命名空間：  Microsoft.Office.Tools.Word
組件：  Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.dll 中)

語法

'宣告
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
)

參數

  • Format
    型別：System.Object%
    列在 [表格自動格式設定] 對話方塊 [格式] 方塊中的格式。可以是其中任何一個 WdTableFormat 常數。根據預設，框線會套用至表格的儲存格中。
  • Style
    型別：System.Object%
    由套用至表格之 [Format] 所指定的 [自動格式設定] 屬性。使用下列值任一組合的加總：
    [1|1] 值
    [1|2] 意義
    [2|1] 0 (零)
    [2|2] 無
    [3|1] 1
    [3|2] 框線
    [4|1] 2
    [4|2] 網底
    [5|1] 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
    型別：System.Object%
    若要建立新表格和資料來源之間的連結，則為 true。
  • Connection
    型別：System.Object%
    執行由 SQLStatement 指定的查詢範圍。指定範圍的方法是依據擷取資料的方式而定。例如：
    透過開放式資料庫連接 (ODBC) 擷取資料時，必須指定連接字串。
    當藉由使用動態資料交換 (DDE) 擷取 Microsoft Office Excel 的資料時，必須指定具名範圍或「整個試算表」。
    注意事項    動態資料交換 (DDE) 是不安全的舊技術。如果可能的話，請使用較安全的技術代替 DDE，如物件連結與嵌入 (Object Linking and Embedding，OLE)。
    當擷取 Microsoft Access 的資料時，必須指定文字「資料表」或「查詢」，然後再指定資料表或查詢的名稱。
  • SQLStatement
    型別：System.Object%
    選擇性的查詢字串會在主要資料來源中擷取希望插入文件的資料子集。
  • SQLStatement1
    型別：System.Object%
    如果查詢字串超過 255 個字元，則 SQLStatement 會代表字串的第一個部分，而 SQLStatement1 會代表第二個部分。
  • PasswordDocument
    型別：System.Object%
    開啟資料來源所需要的密碼 (若有的話)。請參閱下方註解。
  • PasswordTemplate
    型別：System.Object%
    如果資料來源是 Microsoft Office Word 文件，這個引數便是開啟附加範本所需要的密碼 (若有的話)。請參閱下方註解。
  • WritePasswordDocument
    型別：System.Object%
    將變更儲存至文件所需要的密碼 (若有的話)。請參閱下方註解。
  • WritePasswordTemplate
    型別：System.Object%
    將變更儲存至範本所需要的密碼 (若有的話)。請參閱下方註解。
  • DataSource
    型別：System.Object%
    資料來源的路徑和檔案名稱。
  • From
    型別：System.Object%
    資料錄範圍中所要插入的第一筆資料錄編號。
  • To
    型別：System.Object%
    資料錄範圍中所要插入的最後一筆資料錄編號。
  • IncludeFields
    型別：System.Object%
    若要在新資料表的第一列中包含得自資料來源的檔案名稱，則為 true。

備註

避免在您的應用程式中使用固定編碼密碼。 如果程序中需要密碼，請向使用者要求密碼，並將密碼儲存在變數中，再將變數用於程式碼中。

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

可能的情況下，請使用 Windows 使用者帳戶連線至 SQL Server 的「Windows 驗證」(也稱為信任的連接)。 當使用者透過 Windows 使用者帳戶連線時，SQL Server 會使用在 Windows 作業系統中的資訊驗證帳戶名稱與密碼。 在您可以使用 Windows 驗證之前，伺服器管理員必須將 SQL Server 設定為使用這個驗證模式。 如果無法使用 Windows 驗證，請避免儲存使用者的登入資訊。 使用者每次登入時都需輸入登入資訊會提高安全性。

選擇性參數

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

範例

這個範例會將 Microsoft Excel 試算表插入 Bookmark 控制項中。 樣式值 (191) 是數字 1、2、4、8、16、32 及 128 的組合。 這個範例會假設在 C:\ 磁碟中有個名為 Data.xlsx 的活頁簿，並且這個活頁簿的工作表上至少有兩列資料。

這是示範文件層級自訂的範例。

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 安全性

請參閱

參考

Bookmark 介面

Microsoft.Office.Tools.Word 命名空間