WorksheetBase.XmlDataQuery メソッド
特定の 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 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
特定の XPath にマップされたセルを表す Range オブジェクトです。指定された XPath がワークシートにマップされていない場合、またはマップされた範囲が空の場合は nullnull 参照 (Visual Basic では Nothing) です。
解説
XML スプレッドシート形式でファイルを保存する機能以外の XML 機能は、Microsoft Office Professional Edition 2003 および Microsoft Office Excel 2003 でのみ使用できます。
XML リスト内の列に XPath がある場合、返された 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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。