WorksheetBase.XmlMapQuery 方法
取得 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 XmlMapQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlMapQuery(
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 中使用。
與 XmlDataQuery 方法不同的是，XmlMapQuery 方法會傳回 XML 清單的整欄，包含標題列和插入列。
選擇性參數
如需選擇性參數的詳細資訊，請參閱Office 方案中的選擇性參數。
範例
下式程式碼範例會使用 XmlMapQuery 方法，取得對應至特定 XPath 的儲存格 Range。
這是示範文件層級自訂的範例。
Private Sub WorksheetQueryXmlMap()
Dim path As String = "/order/customer/address"
Dim namespaces As String = "xmlns=https://www.contoso.com/orders"
Dim range1 As Excel.Range = _
Me.XmlMapQuery(path, namespaces)
If range1 Is Nothing Then
MsgBox("The specified XPath: '" & path & _
"' has not been mapped to the worksheet.")
End If
End Sub
private void WorksheetQueryXmlMap()
{
string path = "/order/customer/address";
string namespaces = "xmlns=https://www.contoso.com/orders";
Excel.Range range1 = this.XmlMapQuery(path, namespaces, missing);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet.");
}
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。