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

语法

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

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

参数

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

返回值
Range

说明

如果 XPath 存在于 XML 列表的某一列中,则返回的 Range 对象不包括标题行。

如果 XPath 位置路径未映射到网格中,则该方法返回 Nothing。因此,返回 Nothing 并不一定意味着映射不存在。它可能意味着指定的 XPath 位置中当前没有可用的数据区域。可以使用 XmlMapQuery 方法检查是否存在映射的 XPath。

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


请参阅