Метод Worksheet.XmlDataQuery (Excel)
Возвращает объект Range , представляющий ячейки, сопоставленные с определенным XPath. Возвращает значение Nothing , если указанный XPath не сопоставлен с листом или если сопоставленный диапазон пуст.
Синтаксис
expression. XmlDataQuery (XPath, SelectionNamespaces, Map)
Выражение Переменная, представляющая объект Worksheet .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| XPath | Обязательный | String | XPath для запроса. |
| SelectionNamespaces | Необязательный | Variant | Строка с разделителями пробелами, содержащая пространства имен, на которые ссылается параметр XPath. Если не удается устранить одно из указанных пространств имен, возникает ошибка во время выполнения. |
| Map | Необязательный | Variant | Укажите XmlMap , если вы хотите запросить XPath в пределах определенной карты. |
Возвращаемое значение
Range
Замечания
Если XPath существует в столбце в списке XML, возвращаемый объект Range не включает строку заголовка.
Этот метод возвращает значение Nothing , если путь к расположению XPath не сопоставлен с сеткой. Таким образом, возвращение Nothing не обязательно означает, что карта не существует. Это может означать, что в настоящее время отсутствует доступный диапазон данных в указанном расположении XPath. Используйте метод XmlMapQuery , чтобы проверить наличие сопоставленного XPath.
Примечание.
Метод XmlDataQuery позволяет запрашивать наличие определенных данных карты. Его нельзя использовать для запроса фрагмента данных на карте.
Например, он допустим для существования сопоставленного диапазона, в котором XPath для этого диапазона имеет значение "/root/People[@Age="23"]/FirstName". Запрос XmlDataQuery для этого пути расположения XPath возвращает правильный диапазон. Однако запрос на "/root/People[FirstName="Joe"]" поиск "Joe" в указанном выше сопоставленном диапазоне завершается ошибкой, так как определения XPath для сопоставленных диапазонов отличаются.
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.