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 指定的、应用于表的自动套用格式的属性。使用以下值的任何组合之和：[1|1] Value[1|2] 含义[2|1] 0 (零) [2|2] None[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: Object

如果为 true，则创建新表与数据源之间的链接。

Connection: Object

要在其中执行由指定的 SQLStatement查询的范围。指定范围的方式取决于数据的检索方式。例如：通过开放数据库连接 (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，则在新表的第一行中包含来自数据源的字段名。

示例

此示例在控件中插入一个 Microsoft Excel 电子表格 Bookmark 。样式值 (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) 登录帐户。相反，请让系统管理员成为 sysadmin 固定服务器角色的成员，并让他们使用自己的帐户登录。仅当没有其他登录方式时，才使用 sa。若要防止通过 sa 登录帐户进行未经授权的访问，应为该帐户分配一个强、唯一的密码。

如果可能，请使用 Windows 身份验证 (也称为受信任的连接) ，它使用 Windows 用户帐户连接到SQL Server。当用户通过 Windows 用户帐户进行连接时，SQL Server使用 Windows 操作系统中的信息来验证帐户名和密码。在可以使用 Windows 身份验证之前，服务器管理员必须将SQL Server配置为使用此身份验证模式。如果 Windows 身份验证不可用，请避免保存用户的登录信息。用户每次登录时输入登录信息更安全。

可选参数

有关可选参数的信息，请参阅 Office 解决方案中的可选参数。

适用于

通过

Bookmark.InsertDatabase 方法

定义

参数

示例

注解

可选参数

适用于

其他资源