Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método XPathNavigator.MoveToFirstNamespace (XPathNamespaceScope)

 

Publicado: octubre de 2016

Cuando se invalida en una clase derivada, mueve el XPathNavigator hasta el primer nodo de espacio de nombres que coincida con el XPathNamespaceScope especificado.

Espacio de nombres:   System.Xml.XPath
Ensamblado:  System.Xml (en System.Xml.dll)

public abstract bool MoveToFirstNamespace(
	XPathNamespaceScope namespaceScope
)

Parámetros

namespaceScope
Type: System.Xml.XPath.XPathNamespaceScope

Un XPathNamespaceScope valor que describe el ámbito de espacio de nombres.

Valor devuelto

Type: System.Boolean

Devuelve true Si la XPathNavigator desplaza correctamente al primer nodo de espacio de nombres; de lo contrario, false. Si es false, no cambia la posición de XPathNavigator.

La clase XPathNavigator devuelve nodos de espacios de nombres en el orden inverso del documento. Por lo tanto, MoveToFirstNamespace se desplaza básicamente al último nodo de espacios de nombres del ámbito actual.

Con el fragmento XML siguiente como ejemplo, si la XPathNavigator se coloca en el data nodo, MoveToFirstNamespace se comporta de la siguiente manera.

  • MoveToFirstNamespace(XPathNamespaceScope.All) se desplaza hasta uno de los siguientes nodos de espacio de nombres: xmlns:c='C', xmlns:a='A2', xmlns='', xmlns:b='B', o xmlns:xml='http://www.w3.org/XML/1998/namespace'.

  • MoveToFirstNamespace(XPathNamespaceScope.ExcludeXml) se desplaza hasta uno de los siguientes nodos de espacio de nombres: xmlns:c='C', xmlns:a='A2', xmlns='', o xmlns:b='B'.

  • MoveToFirstNamespace(XPathNamespaceScope.Local) se mueve a la xmlns:c='C' nodo.

<root xmlns='urn:default' xmlns:a='A1' xmlns:b='B'>
    <item xmlns='' xmlns:a='A2'>
        <data xmlns:c='C' />
    </item>
</root>

Si el XPathNavigator no se encuentra actualmente en un elemento, este método devuelve false y la posición de la XPathNavigator no cambia. Después de la XPathNavigator se ha movido al nodo de espacio de nombres, el Name propiedad refleja el nombre del espacio de nombres.

Cuando el XPathNavigator se coloca en un nodo de espacio de nombres, los métodos MoveToNext, MoveToPrevious, y MoveToFirst no son aplicables. Estos métodos siempre devuelven false y no cambian la posición de la XPathNavigator. En su lugar, se puede llamar a MoveToNextNamespace para desplazarse hasta el siguiente nodo de espacio de nombres.

Después de la XPathNavigator se coloca en un nodo de espacio de nombres, llamada MoveToParent para volver al nodo de elemento.

Para una definición de los nodos de espacio de nombres, vea la sección 5.4 de la recomendación W3C XML Path Language (XPath) ubicada en http://www.w3.org/TR/xpath#data-model.

.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 4.0
Volver al principio
Mostrar: