WPS 加载项开发 > 表格 API 参考 > Worksheet > 方法 > Worksheet.XmlMapQuery 方法
返回一个代表映射到特定 XPath 的 Range 对象。如果指定的 XPath 路径尚未映射到工作表,则返回 Nothing

语法

表达式.XmlMapQuery(XPath, SelectionNamespaces, Map)

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

参数

名称必选/可选数据类型说明
XPath必选String要查询的 XPath。
SelectionNamespaces可选Variant以空格分隔的 String 类型,包含在 XPath 参数中引用的命名空间。如果无法解析某个指定的命名空间,将产生运行时错误。
Map可选Variant如果希望在特定的映射中查询 XPath,请指定 XML 映射。

返回值
Range

说明

XmlDataQuery 方法不同,XmlMapQuery 方法返回 XML 列表的整个列,其中包括标题行。

注释
利用 XmlMapQuery,开发人员可以查询是否存在具体的映射。该方法无法用于查询映射中的数据片段。例如,映射区域的 XPath 为“/root/People[@Age="23"]/FirstName”是有效的。查询此 XPath 位置路径的 XmlMapQuery 将返回正确区域。但为在以上映射区域中找到“Joe”而对“/root/People[FirstName="Joe"]”进行的查询将失败,原因是映射区域的 XPath 定义不同。


请参阅