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);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet, or the mapped " +
"range is empty.");
}
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。