Worksheet.XmlDataQuery メソッド (Excel)

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

構文

XmlDataQuery (XPathSelectionNamespacesMap)

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

パラメーター

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

戻り値

Range

注釈

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

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

注:

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

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

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

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