WorksheetBase.XmlDataQuery 方法
获取一个 Range 对象，该对象表示映射到特定 XPath 的单元格。 如果指定的 XPath 未映射到工作表，或者如果映射的范围为空，则获取 nullnull 引用（在 Visual Basic 中为 Nothing）。
命名空间： Microsoft.Office.Tools.Excel
程序集： Microsoft.Office.Tools.Excel.v4.0.Utilities（在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中）
语法
声明
Public Function XmlDataQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlDataQuery(
string xPath,
Object selectionNamespaces,
Object map
)
参数
- xPath
类型：System.String
要查询的 XPath。
- selectionNamespaces
类型：System.Object
一个以空格分隔的字符串，其中包含在 XPath 参数中引用的命名空间。如果无法解析指定的命名空间之一，则产生运行时错误。
- map
类型：System.Object
一个 XmlMap。如果要在特定映射中查询 XPath，请指定 XML 映射。
返回值
类型：Microsoft.Office.Interop.Excel.Range
一个 Range 对象，表示映射到特定 XPath 的单元格；如果指定的 XPath 未映射到工作表，或者如果映射的范围为空，则为 nullnull 引用（在 Visual Basic 中为 Nothing）。
备注
XML 功能（除了用于以 XML 电子表格的格式保存文件的功能之外）仅在 Microsoft Office Professional Edition 2003 和 Microsoft Office Excel 2003 中可用。
如果 XPath 存在于 XML 列表中的某一列内，则返回的 Range 对象不包含标题行或插入行。
可选参数
有关可选参数的信息，请参见Office 解决方案中的可选参数。
示例
下面的代码示例使用 XmlDataQuery 方法获取映射到特定 XPath 的单元格的 Range。
此示例针对的是文档级自定义项。
Private Sub WorksheetQueryXmlData()
Dim path As String = "/order/customer/address"
Dim namespaces As String = "xmlns=https://www.contoso.com/orders"
Dim range1 As Excel.Range = _
Me.XmlDataQuery(path, namespaces)
If range1 Is Nothing Then
MsgBox("The specified XPath: '" & path & _
"' has not been mapped to the worksheet, or the mapped " & _
"range is empty.")
End If
End Sub
private void WorksheetQueryXmlData()
{
string path = "/order/customer/address";
string namespaces = "xmlns=https://www.contoso.com/orders";
Excel.Range range1 = this.XmlDataQuery(path, namespaces, missing);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet, or the mapped " +
"range is empty.");
}
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。