WorksheetBase.XmlMapQuery メソッド
特定の XPath にマップされているセルを表す Range オブジェクトを取得します。 指定された 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
特定の XPath にマップされたセルを表す Range オブジェクトです。指定された 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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。