XPathNavigator.MoveToFirstNamespace Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перемещает XPathNavigator к первому узлу пространства имен текущего узла.
Перегрузки
MoveToFirstNamespace(XPathNamespaceScope) |
При переопределении в производном классе перемещает XPathNavigator к первому узлу пространства имен, соответствующему указанному XPathNamespaceScope. |
MoveToFirstNamespace() |
Перемещает XPathNavigator к первому узлу пространства имен текущего узла. |
MoveToFirstNamespace(XPathNamespaceScope)
При переопределении в производном классе перемещает XPathNavigator к первому узлу пространства имен, соответствующему указанному XPathNamespaceScope.
public:
abstract bool MoveToFirstNamespace(System::Xml::XPath::XPathNamespaceScope namespaceScope);
public abstract bool MoveToFirstNamespace (System.Xml.XPath.XPathNamespaceScope namespaceScope);
abstract member MoveToFirstNamespace : System.Xml.XPath.XPathNamespaceScope -> bool
Public MustOverride Function MoveToFirstNamespace (namespaceScope As XPathNamespaceScope) As Boolean
Параметры
- namespaceScope
- XPathNamespaceScope
Значение XPathNamespaceScope, описывающее область пространства имен.
Возвращаемое значение
true
, если XPathNavigator успешно перемещается к первому узлу пространства имен, иначе — false
. Если возвращается значение false
, то положение XPathNavigator остается неизменным.
Комментарии
Класс XPathNavigator возвращает узлы пространства имен в обратном порядке документа. Поэтому MoveToFirstNamespace существенно перемещается к последнему узлу пространства имен в текущей области видимости.
При использовании следующего фрагмента XML в качестве примера, если XPathNavigator он расположен на data
узле, MoveToFirstNamespace поведение выполняется следующим образом.
MoveToFirstNamespace(XPathNamespaceScope.All)
перемещается на один из следующих узлов пространства имен:xmlns:c='C'
,xmlns:a='A2'
,xmlns=''
,xmlns:b='B'
илиxmlns:xml='http://www.w3.org/XML/1998/namespace'
.MoveToFirstNamespace(XPathNamespaceScope.ExcludeXml)
перемещается на один из следующих узлов пространства имен:xmlns:c='C'
,xmlns:a='A2'
,xmlns=''
илиxmlns:b='B'
.MoveToFirstNamespace(XPathNamespaceScope.Local)
перемещается наxmlns:c='C'
узел.
<root xmlns='urn:default' xmlns:a='A1' xmlns:b='B'>
<item xmlns='' xmlns:a='A2'>
<data xmlns:c='C' />
</item>
</root>
Если объект XPathNavigator не располагается в данный момент в элементе, этот метод возвращается false
, а позиция элемента XPathNavigator не изменяется. После перемещения в XPathNavigator узел Name пространства имен свойство отражает имя пространства имен.
Если он XPathNavigator размещается на узле пространства имен, методы MoveToNextMoveToPreviousи MoveToFirst неприменимы. Эти методы всегда возвращаются false
и не изменяют положение XPathNavigatorобъекта . Вместо этого можно вызвать MoveToNextNamespace переход к следующему узлу пространства имен.
XPathNavigator После размещения на узле пространства имен вызовите MoveToParent для возврата к узлу элемента.
Определение узлов пространства имен см. в разделе 5.4 рекомендации W3C по языку пути XML (XPath).
См. также раздел
Применяется к
MoveToFirstNamespace()
Перемещает XPathNavigator к первому узлу пространства имен текущего узла.
public:
bool MoveToFirstNamespace();
public bool MoveToFirstNamespace ();
member this.MoveToFirstNamespace : unit -> bool
Public Function MoveToFirstNamespace () As Boolean
Возвращаемое значение
true
, если XPathNavigator успешно перемещается к первому узлу пространства имен, иначе — false
. Если возвращается значение false
, то положение XPathNavigator остается неизменным.
Комментарии
Класс XPathNavigator возвращает узлы пространства имен в обратном порядке документа. Поэтому MoveToFirstNamespace существенно перемещается к последнему узлу пространства имен в текущей области видимости.
После перемещения в XPathNavigator узел Name пространства имен свойство отражает имя пространства имен.
Если он XPathNavigator размещается на узле пространства имен, методы MoveToNextMoveToPreviousи MoveToFirst неприменимы. Эти методы всегда возвращаются false
и не изменяют положение XPathNavigatorобъекта . Вместо этого можно вызвать MoveToNextNamespace переход к следующему узлу пространства имен.
XPathNavigator После размещения на узле пространства имен вызовите MoveToParent для возврата к узлу элемента.
Определение узлов пространства имен см. в разделе 5.4 рекомендации W3C по языку пути XML (XPath).