Перейти к основному содержимому

ВыражениеXPathЧтенияXml

Стд::Xml::XPath::ВыражениеXPathЧтенияXml Доступность: Сервер

Объект для выражения XPath чтения XML.

Сравнение ссылочное

Иерархия типа

Базовые типы: Объект


См. также

ЧтениеXml


Конструкторы

ВыражениеXPathЧтенияXml

Доступность: Сервер

ВыражениеXPathЧтенияXml(
Значение: Строка,
ПрефиксыПространствИмен: ЧитаемоеСоответствие<Строка, Строка>? = Неопределено)
Конструктор выражения XPath для потоковой обработки XML, используется только в типе ЧтениеXml.

  • Значение - строка с выражением XPath
  • ПрефиксыПространствИмен - соответствие Префикс - Пространство имен, по умолчанию Undefined

Описание синтаксиса

Выражение XPath для чтения XML имеет следующие возможности и ограничения:

  • однонаправленный поиск от начала документа
  • поддержка осей
    • child (ось по умолчанию, child::elem → elem)
    • descendant (//)
    • attribute (@)
  • условия
    • только атрибуты контекстного элемента
    • только оператор and
    • для контекстного элемента не допускается цепочка условий (например, нельзя использовать //elem[@attr='1'][@attr2='2'])
    • операторы сравнения
      • =, != , <, <=, >, >=
        • для <, <=, >, >= выполняется неявное приведение к числу
      • если оператор не указан, то выполняется проверка на наличие значения атрибута
    • функции проверки значения на вхождение подстроки (есть зависимость от регистра)
      • contains
      • starts-with
      • ends-with
  • нельзя использовать wildcard (*)
  • нельзя использовать параметры
    • можно использовать интерполяцию для построения строки выражения

Исключения

ИсключениеНедопустимыйФормат - если значение выражения не соответствует синтаксису XPath для чтения XML ИсключениеНедопустимыйАргумент - если в выражении используется префикс, но он отсутствует в ПрефиксыПространствИмен

Примеры

  • /root/elem
  • /root/elem[@attr = 'a' and @attr2 = 'c']/elem[@attr = 'b']
  • //elem/elem
  • //elem[@attr = 'a']/elem[@attr = 'b']
  • //elem[@attr]
  • //elem[contains(@attr, 'b')]
  • //elem[starts-with(@attr, 'a')]
  • //elem[ends-with(@attr, 'z')]

Свойства

Значение

Доступность: Сервер ТолькоЧтение

Значение: Строка

Строковое значение выражения XPath.


ПрефиксыПространствИмен

Доступность: Сервер ТолькоЧтение

ПрефиксыПространствИмен: ЧитаемоеСоответствие<Строка, Строка>?

Соответствие Префикс - Пространство имен, обязательно для заполнения в для выражением с использованием пространств имен, в том числе пространства имен по умолчанию. Значение по умолчанию - Undefined


Список унаследованных методов

Объект

ВСтроку, ПолучитьТип, Представление