WPS 加载项开发 > 表格 API 参考 > Workbook > 方法 > Workbook.XmlImport 方法
将 XML 数据文件导入当前工作簿。

语法

表达式.XmlImport(Url, ImportMap, Overwrite, Destination)

表达式   一个代表 Workbook 对象的变量。

参数

名称必选/可选数据类型说明
Url必选StringXML 数据文件的统一资源定位符 (URL) 或通用命名约定 (UNC) 路径。
ImportMap必选XmlMap导入文件时要应用的架构映射。如果以前导入过该数据,则包含对 XmlMap 对象(包含该数据)的引用。
Overwrite可选Variant如果未指定 Destination 参数的值,则该参数将指定是否覆盖已映射到在 ImportMap 参数中指定的架构映射的数据。设置为 True 将覆盖数据,设置为 False 将把新数据追加到现有数据中。默认值为 True。如果指定了 Destination 参数的值,则该参数将指定是否覆盖现有数据。设置为 True 将覆盖现有数据,设置为 False 将在数据要被覆盖时取消导入。默认值为 True
Destination可选Variant指定将在其中创建列表的区域。只能使用区域的左上角。

返回值
XlXmlImportResult

说明

XlXmlImportResult 可为以下 XlXmlImportResult 常量之一。
xlXmlImportElementsTruncated。由于指定的 XML 数据文件对于工作表来说太大,因此其内容已被截断。
xlXmlImportSuccess。XML 数据文件成功导入。
xlXmlImportValidationFailed。正导入的数据未能通过架构验证,但仍进行导入。

该方法使您可以从文件路径中将数据导入工作簿中。 ET 使用找到的第一个符合需要的映射;如果指定了目标区域,则 ET 将自动列出该数据。

如果希望将数据导入到现有映射,请不要指定 Destination 参数的值。

以下条件会导致 XMLImport 方法产生运行时错误:

使用 Workbook 对象的 XmlImportXml 方法可导入先前加载到内存中的 XML 数据。


请参阅