WPS 加载项开发 > 文字 API 参考 > Range > 方法 > Range.InsertDatabase 方法
从数据源（例如，单独的 WPS 文档、WPS OfficeET 工作表或 WPS OfficeAccess 数据库）检索数据，并以表格形式插入数据，以替换指定区域。

语法

表达式.InsertDatabase(Format, Style, LinkToSource, Connection, SQLStatement, SQLStatement1, PasswordDocument, PasswordTemplate, WritePasswordDocument, WritePasswordTemplate, DataSource, From, To, IncludeFields)

表达式   必需。一个代表 Range 对象的变量。

参数

名称 必选/可选 数据类型 说明
Format 可选 Variant “表格”菜单“表格自动套用格式”对话框的“格式”框中列出的一种格式。可以是任意 WdTableFormat 常量。默认情况下，边框应用于表格单元格。
Style 可选 Variant Format 指定的应用于表的自动套用格式的属性。
LinkToSource 可选 Variant 如果该属性值为 True，则在新表和数据源之间建立一个链接。
Connection 可选 Variant SQLStatement 指定的在其中执行查询的区域。
SQLStatement 可选 String 检索主数据源中要插入文档的数据集。
SQLStatement1 可选 String 如果查询字符串长于 255 个字符，则 SQLStatement 代表字符串的第一部分，而 SQLStatement1 代表第二部分。
PasswordDocument 可选 Variant 打开数据源所需的密码（如果有。请参阅下面的“说明”）。
PasswordTemplate 可选 Variant 如果数据源是 WPS 文档，则该参数是打开附加模板所需的密码（如果有。请参阅下面的“说明”）。
WritePasswordDocument 可选 Variant 保存对文档所作修改所需的密码（如果有。请参阅下面的“说明”）。
WritePasswordTemplate 可选 Variant 保存对模板所作修改所需的密码（如果有。请参阅下面的“说明”）。
DataSource 可选 Variant 数据源的路径和文件名称。
From 可选 Variant 要插入的记录区域中第一条记录的编号。
To 可选 Variant 要插入的记录区域中最后一条记录的编号。
IncludeFields 可选 Variant 如果该属性值为 True，则在新表的第一行包含数据源的域名。

说明

Style 参数的值可为以下值的任意组合的总和：

值 含义
0（零） 无
1 边框
2 底纹
4 字体
8 对应颜色
16 自动填充
32 标题行
64 最后一行
128 第一列
256 最后一列

指定 Connection 参数的方式取决于检索数据的方式。例如：

安全性

请避免在应用程序中使用硬编码的密码。如果过程中要求输入密码，请从用户处请求密码，并将密码作为变量存储起来，然后在代码中使用该变量。有关如何做到这一点的建议最佳操作，请参阅 WPS Office解决方案开发人员安全注意事项。

安全性??请避免使用内置系统管理员 (sa) 登录帐户。使系统管理员成为 sysadmin 固定服务器角色，让他们使用自己的帐户登录。只有在没有其他方法登录时才使用 sa 。为了防止通过 sa 登录帐户进行未经授权的访问，应该为该帐户分配唯一的强密码。

安全性??请尽可能使“Windows 验证”（也称为信任连接），该验证使用 Windows 用户帐户连接 SQL Server。当用户通过 Windows 用户帐户进行连接时，SQL Server 将使用 Windows 操作系统中的信息来验证帐户名称和密码。只有在服务器管理员将 SQL Server 配置为使用“Windows 验证”时，才能使用“Windows 验证”。如果“Windows 验证”不可用，请避免保存用户的 ' 登录信息。用户在每次登录时都输入登录信息才是更安全的做法。

示例

本示例在所选内容之后插入名为“Data.xls”的 ET 电子表格。Style 值 (191) 是 1、2、4、8、16、32 和 128 这几个数的和。

示例代码 
Selection.Collapse(wdCollapseEnd)
Selection.Range.InsertDatabase(wdTableFormatSimple2, 191, false, "Entire Spreadsheet", null, null, null, null, null, null, "C:\\WPSOffice\\Excel\\Data.xls")


请参阅