Worksheet.XmlDataQuery メソッド (Excel)

特定の XPath に マップされたセルを表す Range オブジェクトを返します。 指定した XPath がワークシートにマッピングされていない場合、またはマッピングされた範囲が空の場合は、Nothing を返します。

構文

XmlDataQuery (XPath, SelectionNamespaces, Map)

Worksheet オブジェクトを表す変数。

パラメーター

名前 必須 / オプション データ型 説明
XPath 必須 String 対象となる XPath を指定します。
SelectionNamespaces 省略可能 Variant XPath パラメーター で参照される 名前空間を含むスペース区切り文字列。 指定した名前空間の 1 つを解決できない場合は、実行時エラーが生成されます。
Map 省略可能 Variant 特定の マップ内で XPath をクエリする場合は、XmlMap を指定します。

戻り値

Range

注釈

XPath が XML リストの列内の一部に存在する場合、返される Range オブジェクトには、見出し行も挿入行も含まれません。

XPath がグリッドにマップされていなかった場合、Nothing が返されます。 したがって、Nothing が返されたからといって、必ずしもマップが存在しないとは限りません。 指定された XPath に、利用できるデータ範囲が存在していないことも考えられます。 マップされた XPath の 存在を確認するには、XmlMapQuery メソッドを使用します。

注意

XmlDataQuery メソッドは、特定のマップ データが存在するかどうかを確認する場合に使用します。 マップ内のデータのクエリには使用できません。

たとえば、マップされた範囲が存在し、その範囲の XPath "/root/People[@Age="23"]/FirstName"が . この XPath 場所パスの XmlDataQuery クエリは、正しい範囲を返します。 ただし、マップされた "/root/People[FirstName="Joe"]" 範囲の XPath 定義が異なって、上記のマップ範囲内で "Joe" を検索するクエリは失敗します。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。