Compartir a través de


XPathNavigator Clase

Definición

Proporciona un modelo de cursor para navegar y editar datos XML.

public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, ICloneable, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : ICloneable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, ICloneable, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : ICloneable
type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXmlNamespaceResolver
    interface IXPathNavigable
type XPathNavigator = class
    inherit XPathItem
    interface IXmlNamespaceResolver
    interface IXPathNavigable
type XPathNavigator = class
    interface ICloneable
type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXPathNavigable
    interface IXmlNamespaceResolver
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements ICloneable, IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Implements ICloneable
Herencia
XPathNavigator
Herencia
XPathNavigator
Derivado
Implementaciones

Comentarios

La XPathNavigator clase del System.Xml.XPath espacio de nombres es una clase abstracta que define un modelo de cursor para navegar y editar elementos de información XML como instancias del modelo de datos XQuery 1.0 y XPath 2.0.

Se XPathNavigator crea un objeto a partir de una clase que implementa la IXPathNavigable interfaz como las XPathDocument clases y XmlDocument . XPathNavigator los objetos creados por XPathDocument los objetos son de solo lectura, mientras XPathNavigator que los objetos creados por XmlDocument objetos se pueden editar. El estado de solo lectura o editable de un XPathNavigator objeto se determina mediante la CanEdit propiedad de la XPathNavigator clase .

Para obtener más información sobre el procesamiento de datos XML mediante el modelo de datos XPath, vea el tema Procesar datos XML mediante el modelo de datos XPath .

Importante

Las excepciones generadas como resultado del uso de la XPathNavigator clase , como la XPathException clase , pueden contener información confidencial que no se debe exponer en escenarios que no son de confianza. Las excepciones deben controlarse correctamente para que esta información confidencial no se exponga en escenarios que no son de confianza.

Notas a los implementadores

Al heredar de la XPathNavigator clase , debe invalidar los siguientes miembros:

Constructores

XPathNavigator()

Inicializa una nueva instancia de la clase XPathNavigator.

Propiedades

BaseURI

Cuando se reemplaza en una clase derivada, obtiene el URI base del nodo actual.

CanEdit

Obtiene un valor que indica si el elemento XPathNavigator puede editar los datos XML subyacentes.

HasAttributes

Obtiene un valor que indica si el nodo actual tiene algún atributo.

HasChildren

Obtiene un valor que indica si el nodo actual tiene algún nodo secundario.

InnerXml

Obtiene o establece el marcado que representa los nodos secundarios del nodo actual.

IsEmptyElement

Cuando se invalida en una clase derivada, obtiene un valor que indica si el nodo actual es un elemento vacío sin etiqueta de cierre de elemento.

IsNode

Obtiene un valor que indica si el nodo actual representa un nodo XPath.

LocalName

Cuando se reemplaza en una clase derivada, obtiene el Name del nodo actual sin prefijo de espacio de nombres.

Name

Cuando se invalida en una clase derivada, obtiene el nombre completo del nodo actual.

NamespaceURI

Cuando se reemplaza en una clase derivada, obtiene el URI de espacio de nombres del nodo actual.

NameTable

Cuando se reemplaza en una clase derivada, obtiene el XmlNameTable de XPathNavigator.

NavigatorComparer

Obtiene un IEqualityComparer que se usa para la comparación de igualdad de objetos XPathNavigator.

NodeType

Cuando se reemplaza en una clase derivada, obtiene el XPathNodeType del nodo actual.

OuterXml

Obtiene o establece el marcado que representa las etiquetas de apertura y cierre del nodo actual y sus nodos secundarios.

Prefix

Cuando se invalida en una clase derivada, obtiene el prefijo de espacio de nombres asociado al nodo actual.

SchemaInfo

Obtiene la información de esquema asignada al nodo actual como resultado de la validación del esquema.

TypedValue

Obtiene el nodo actual como un objeto con la conversión boxing aplicada del tipo .NET más adecuado.

UnderlyingObject

Lo utilizan las implementaciones de XPathNavigator que proporcionan una vista XML "virtual" sobre un almacén para proporcionar acceso a los objetos subyacentes.

Value

Cuando se invalida en una clase derivada, obtiene el valor de cadena del elemento.

Value

Cuando se reemplaza en una clase derivada, obtiene el valor string del elemento.

(Heredado de XPathItem)
ValueAsBoolean

Obtiene el valor del nodo actual como un valor de tipo Boolean.

ValueAsDateTime

Obtiene el valor del nodo actual como un valor de tipo DateTime.

ValueAsDouble

Obtiene el valor del nodo actual como un valor de tipo Double.

ValueAsInt

Obtiene el valor del nodo actual como un valor de tipo Int32.

ValueAsLong

Obtiene el valor del nodo actual como un valor de tipo Int64.

ValueType

Obtiene el objeto .NET Type del nodo actual.

XmlLang

Obtiene el xml:lang ámbito del nodo actual.

XmlType

Obtiene la información de XmlSchemaType del nodo actual.

XmlType

Cuando se reemplaza en una clase derivada, obtiene XmlSchemaType del elemento.

(Heredado de XPathItem)

Métodos

AppendChild()

Devuelve un objeto XmlWriter utilizado para crear uno más nuevos nodos secundarios al final de la lista de nodos secundarios del nodo actual.

AppendChild(String)

Crea un nuevo nodo secundario al final de la lista de nodos secundarios del nodo actual usando la cadena de datos XML especificada.

AppendChild(XmlReader)

Crea un nuevo nodo secundario al final de la lista de nodos secundarios del nodo actual mediante el contenido XML del objeto XmlReader especificado.

AppendChild(XPathNavigator)

Crea un nuevo nodo secundario al final de la lista de nodos secundarios del nodo actual mediante los nodos del XPathNavigator especificado.

AppendChildElement(String, String, String, String)

Crea un nuevo nodo de elemento secundario al final de la lista de nodos secundarios del nodo actual mediante el prefijo de espacio de nombres, el nombre local y el URI de espacio de nombres especificados con el valor seleccionado.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Comprueba que los datos XML de XPathNavigator se ajustan al esquema del lenguaje de definición de esquemas XML (XSD) proporcionado.

Clone()

Cuando se reemplaza en una clase derivada, se crea un nuevo XPathNavigator que se coloca en el mismo nodo que este XPathNavigator.

ComparePosition(XPathNavigator)

Compara la posición del XPathNavigator actual con la del XPathNavigator especificado.

Compile(String)

Compila una cadena que representa una expresión XPath y devuelve un objeto XPathExpression.

CreateAttribute(String, String, String, String)

Crea un nodo de atributo en el nodo del elemento actual usando el prefijo de espacio de nombres, el nombre local y el URI de espacio de nombres especificado con el valor especificado.

CreateAttributes()

Devuelve un objeto XmlWriter utilizado para crear nuevos atributos en el elemento actual.

CreateNavigator()

Devuelve una copia de XPathNavigator.

DeleteRange(XPathNavigator)

Elimina un intervalo de nodos relacionados desde el nodo actual hasta el nodo especificado.

DeleteSelf()

Elimina el nodo actual y sus nodos secundarios.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
Evaluate(String)

Evalúa la expresión XPath especificada y devuelve el resultado de tipo.

Evaluate(String, IXmlNamespaceResolver)

Evalúa la expresión XPath especificada y devuelve el resultado de tipo mediante el objeto IXmlNamespaceResolver especificado para resolver prefijos de espacio de nombres en la expresión XPath.

Evaluate(XPathExpression)

Evalúa la expresión XPathExpression y devuelve el resultado de tipo.

Evaluate(XPathExpression, XPathNodeIterator)

Utiliza el contexto proporcionado para evaluar la expresión XPathExpression y devuelve el resultado con tipo.

GetAttribute(String, String)

Obtiene el valor del atributo con el nombre local y el identificador URI de espacio de nombres que se hayan especificado.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetNamespace(String)

Devuelve el valor del nodo Namespace correspondiente al nombre local especificado.

GetNamespacesInScope(XmlNamespaceScope)

Devuelve los espacios de nombres en el ámbito del nodo actual.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InsertAfter()

Devuelve un objeto XmlWriter utilizado para crear un nuevo nodo relacionado detrás el nodo seleccionado actualmente.

InsertAfter(String)

Crea un nuevo nodo relacionado detrás del nodo seleccionado actualmente usando la cadena XML especificada.

InsertAfter(XmlReader)

Crea un nuevo nodo relacionado detrás del nodo actualmente seleccionado usando el contenido XML del objeto XmlReader especificado.

InsertAfter(XPathNavigator)

Crea un nuevo nodo relacionado detrás del nodo actualmente seleccionado mediante los nodos del objeto XPathNavigator especificado.

InsertBefore()

Devuelve un objeto XmlWriter utilizado para crear un nuevo nodo relacionado delante el nodo seleccionado actualmente.

InsertBefore(String)

Crea un nuevo nodo relacionado delante del nodo seleccionado actualmente usando la cadena XML especificada.

InsertBefore(XmlReader)

Crea un nuevo nodo relacionado antes del nodo actualmente seleccionado usando el contenido XML del objeto XmlReader especificado.

InsertBefore(XPathNavigator)

Crea un nuevo nodo relacionado antes del nodo actualmente seleccionado mediante los nodos del XPathNavigator especificado.

InsertElementAfter(String, String, String, String)

Crea un nuevo elemento relacionado detrás del nodo actual mediante el prefijo de espacio de nombres, el nombre local y el URI de espacio de nombres especificado con el valor seleccionado.

InsertElementBefore(String, String, String, String)

Crea un nuevo elemento relacionado delante del nodo actual mediante el prefijo de espacio de nombres, el nombre local y el URI de espacio de nombres especificado con el valor seleccionado.

IsDescendant(XPathNavigator)

Determina si el objeto XPathNavigator especificado es un descendiente del objeto actual XPathNavigator.

IsSamePosition(XPathNavigator)

Cuando se reemplaza en una clase derivada, determina si el XPathNavigator actual está en la misma posición que el XPathNavigator especificado.

LookupNamespace(String)

Obtiene el identificador URI de espacio de nombres del prefijo especificado.

LookupPrefix(String)

Obtiene el prefijo declarado del URI de espacio de nombres especificado.

Matches(String)

Determina si el nodo actual coincide con la expresión XPath especificada.

Matches(XPathExpression)

Determina si el nodo actual coincide con la expresión XPathExpression especificada.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MoveTo(XPathNavigator)

Cuando se reemplaza en una clase derivada, mueve XPathNavigator a la misma posición que el XPathNavigator especificado.

MoveToAttribute(String, String)

Mueve el XPathNavigator hasta el atributo cuyo nombre local y URI de espacio de nombres coincidan.

MoveToChild(String, String)

Desplaza el objeto XPathNavigator hasta el nodo secundario con el nombre local y el URI de espacio de nombres especificados.

MoveToChild(XPathNodeType)

Mueve XPathNavigator al nodo secundario del objeto XPathNodeType especificado.

MoveToFirst()

Mueve XPathNavigator al primer nodo relacionado del nodo actual.

MoveToFirstAttribute()

Cuando se reemplaza en una clase derivada, el objeto XPathNavigator se desplaza hasta el primer atributo del nodo actual.

MoveToFirstChild()

Cuando se reemplaza en una clase derivada, el objeto XPathNavigator se desplaza hasta el primer nodo secundario del nodo actual.

MoveToFirstNamespace()

Desplaza el objeto XPathNavigator hasta el primer nodo de espacio de nombres del nodo actual.

MoveToFirstNamespace(XPathNamespaceScope)

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

MoveToFollowing(String, String)

Mueve el XPathNavigator al elemento con el nombre local y el URI de espacio de nombres especificados en el orden del documento.

MoveToFollowing(String, String, XPathNavigator)

Mueve el XPathNavigator al elemento con el nombre local y el URI de espacio de nombres especificados, al límite especificado, en el orden del documento.

MoveToFollowing(XPathNodeType)

Mueve el XPathNavigator al elemento siguiente del XPathNodeType especificado en el orden del documento.

MoveToFollowing(XPathNodeType, XPathNavigator)

Mueve el XPathNavigator al siguiente elemento del XPathNodeType especificado, al límite especificado, en el orden del documento.

MoveToId(String)

Cuando se reemplaza en una clase derivada, se mueve al nodo que tiene un atributo de tipo ID cuyo valor coincide con el especificado String.

MoveToNamespace(String)

Desplaza el objeto XPathNavigator hasta el nodo de espacio de nombres con el prefijo correspondiente especificado.

MoveToNext()

Cuando se reemplaza en una clase derivada, desplaza el objeto XPathNavigator hasta el primer nodo relacionado del nodo actual.

MoveToNext(String, String)

Desplaza el objeto XPathNavigator hasta el siguiente nodo relacionado con el nombre local y el URI de espacio de nombres especificados.

MoveToNext(XPathNodeType)

Mueve el objeto XPathNavigator al siguiente nodo relacionado del nodo actual que coincida con el XPathNodeType especificado.

MoveToNextAttribute()

Cuando se reemplaza en una clase derivada, XPathNavigator se desplaza hasta el siguiente atributo.

MoveToNextNamespace()

Desplaza el objeto XPathNavigator hasta el siguiente nodo Namespace.

MoveToNextNamespace(XPathNamespaceScope)

Cuando se reemplaza en una clase derivada, mueve XPathNavigator al siguiente nodo de espacio de nombres que coincida con el XPathNamespaceScope especificado.

MoveToParent()

Cuando se reemplaza en una clase derivada, el objeto XPathNavigator se desplaza hasta el nodo primario del nodo actual.

MoveToPrevious()

Cuando se reemplaza en una clase derivada, desplaza el objeto XPathNavigator hasta el nodo relacionado anterior del nodo actual.

MoveToRoot()

Desplaza XPathNavigator hasta el nodo raíz al que pertenece el nodo actual.

PrependChild()

Devuelve un objeto XmlWriter utilizado para crear un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual.

PrependChild(String)

Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual usando la cadena XML especificada.

PrependChild(XmlReader)

Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual mediante el contenido XML del objeto XmlReader especificado.

PrependChild(XPathNavigator)

Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual mediante los nodos del objeto XPathNavigator especificado.

PrependChildElement(String, String, String, String)

Crea un nuevo nodo de elemento secundario al principio de la lista de nodos secundarios del nodo actual mediante el prefijo de espacio de nombres, el nombre local y el URI de espacio de nombres especificados con el valor seleccionado.

ReadSubtree()

Devuelve un objeto XmlReader que contiene el nodo actual y sus nodos secundarios.

ReplaceRange(XPathNavigator)

Reemplaza un intervalo de nodos relacionados desde el nodo actual hasta al nodo especificado.

ReplaceSelf(String)

Reemplaza el nodo actual por el contenido de la cadena especificada.

ReplaceSelf(XmlReader)

Reemplaza el nodo actual por el contenido del objeto XmlReader especificado.

ReplaceSelf(XPathNavigator)

Reemplaza el nodo actual por el contenido del objeto XPathNavigator especificado.

Select(String)

Selecciona un conjunto de nodos utilizando la expresión XPath especificada.

Select(String, IXmlNamespaceResolver)

Selecciona un conjunto de nodos mediante la expresión XPath especificada con el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres.

Select(XPathExpression)

Selecciona un conjunto de nodos utilizando la expresión XPathExpression especificada.

SelectAncestors(String, String, Boolean)

Selecciona todos los nodos antecesores del nodo actual que tengan el nombre local y el URI de espacio de nombres especificados.

SelectAncestors(XPathNodeType, Boolean)

Selecciona todos los nodos antecesores del nodo actual que tengan un XPathNodeType correspondiente.

SelectChildren(String, String)

Selecciona todos los nodos secundarios del nodo actual que tengan el nombre local y el URI de espacio de nombres especificados.

SelectChildren(XPathNodeType)

Selecciona todos los nodos secundarios del nodo actual que tengan el XPathNodeType correspondiente.

SelectDescendants(String, String, Boolean)

Selecciona todos los nodos descendientes del nodo actual que tengan el nombre local y el URI de espacio de nombres especificados.

SelectDescendants(XPathNodeType, Boolean)

Selecciona todos los nodos descendientes del nodo actual que tengan un XPathNodeType correspondiente.

SelectSingleNode(String)

Selecciona un solo nodo en el XPathNavigator mediante la consulta XPath especificada.

SelectSingleNode(String, IXmlNamespaceResolver)

Selecciona un solo nodo del objeto XPathNavigator utilizando la consulta XPath especificada con el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres.

SelectSingleNode(XPathExpression)

Selecciona un solo nodo en el XPathNavigator mediante el objeto XPathExpression especificado.

SetTypedValue(Object)

Establece el valor con tipo del nodo actual.

SetValue(String)

Establece el valor del nodo actual.

ToString()

Obtiene el valor de texto del nodo actual.

ValueAs(Type)

Devuelve el valor del elemento como el tipo especificado.

(Heredado de XPathItem)
ValueAs(Type, IXmlNamespaceResolver)

Obtiene el valor del nodo actual como el Type especificado mediante el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres.

WriteSubtree(XmlWriter)

Envía la secuencia del nodo actual y sus nodos secundarios al objeto XmlWriter especificado.

Implementaciones de interfaz explícitas

ICloneable.Clone()

Crea una nueva copia del objeto XPathNavigator.

Se aplica a

Consulte también