XPathNavigator Clase

Definición

Espacio de nombres:

System.Xml.XPath

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XPathNavigator.cs

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 abstract class XPathNavigator : System.Xml.XPath.XPathItem, ICloneable, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable

type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXmlNamespaceResolver
    interface IXPathNavigable

Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements ICloneable, IXmlNamespaceResolver, IXPathNavigable

Herencia

Object

XPathItem

XPathNavigator

Derivado

System.ServiceModel.Dispatcher.SeekableXPathNavigator

Implementaciones

ICloneable IXmlNamespaceResolver IXPathNavigable

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 objetos son de solo lectura mientras XPathNavigator se pueden editar objetos creados por XmlDocument objetos. 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, consulte 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 miembros siguientes:

• NameTable

• Clone()

• NodeType

• LocalName

• Name

• NamespaceURI

• Prefix

• BaseURI

• IsEmptyElement

• MoveToFirstAttribute()

• MoveToNextAttribute()

• MoveToFirstNamespace(XPathNamespaceScope)

• MoveToNextNamespace(XPathNamespaceScope)

• MoveToNext()

• MoveToPrevious()

• MoveToFirstChild()

• MoveToParent()

• MoveTo(XPathNavigator)

• MoveToId(String)

• IsSamePosition(XPathNavigator)

• Value

Constructores

Nombre	Description
XPathNavigator()	Inicializa una nueva instancia de la clase XPathNavigator.

Propiedades

Nombre	Description
BaseURI	Cuando se reemplaza en una clase derivada, obtiene el URI base para el nodo actual.
CanEdit	Obtiene un valor que indica si XPathNavigator puede editar los datos XML subyacentes.
HasAttributes	Obtiene un valor que indica si el nodo actual tiene atributos.
HasChildren	Obtiene un valor que indica si el nodo actual tiene nodos secundarios.
InnerXml	Obtiene o establece el marcado que representa los nodos secundarios del nodo actual.
IsEmptyElement	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si el nodo actual es un elemento vacío sin una etiqueta de elemento final.
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 ningún prefijo de espacio de nombres.
Name	Cuando se reemplaza en una clase derivada, obtiene el nombre completo del nodo actual.
NamespaceURI	Cuando se reemplaza en una clase derivada, obtiene el URI del espacio de nombres del nodo actual.
NameTable	Cuando se reemplaza en una clase derivada, obtiene el XmlNameTable de .XPathNavigator
NavigatorComparer	Obtiene un IEqualityComparer objeto utilizado para la comparación de igualdad de XPathNavigator objetos.
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 reemplaza en una clase derivada, obtiene el prefijo de espacio de nombres asociado al nodo actual.
SchemaInfo	Obtiene la información de esquema que se ha asignado al nodo actual como resultado de la validación del esquema.
TypedValue	Obtiene el nodo actual como un objeto boxed del tipo de .NET más adecuado.
UnderlyingObject	Se usa en XPathNavigator implementaciones que proporcionan una vista XML "virtualizada" a través de un almacén, para proporcionar acceso a los objetos subyacentes.
Value	Cuando se reemplaza en una clase derivada, obtiene el string valor del elemento. (Heredado de XPathItem)
ValueAsBoolean	Obtiene el valor del nodo actual como .Boolean
ValueAsDateTime	Obtiene el valor del nodo actual como .DateTime
ValueAsDouble	Obtiene el valor del nodo actual como .Double
ValueAsInt	Obtiene el valor del nodo actual como .Int32
ValueAsLong	Obtiene el valor del nodo actual como .Int64
ValueType	Obtiene .NET Type del nodo actual.
XmlLang	Obtiene el xml:lang ámbito del nodo actual.
XmlType	Obtiene la XmlSchemaType información del nodo actual.

Métodos

Nombre	Description
AppendChild()	Devuelve un XmlWriter objeto usado para crear uno o varios nodos secundarios nuevos 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 mediante 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 XmlReader objeto 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 del espacio de nombres, el nombre local y el URI del espacio de nombres especificados con el valor especificado.
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, crea una nueva XPathNavigator posición en el mismo nodo que este XPathNavigator.
ComparePosition(XPathNavigator)	Compara la posición del actual XPathNavigator con la posición del XPathNavigator especificado.
Compile(String)	Compila una cadena que representa una expresión XPath y devuelve un XPathExpression objeto .
CreateAttribute(String, String, String, String)	Crea un nodo de atributo en el nodo de elemento actual mediante el prefijo del espacio de nombres, el nombre local y el URI del espacio de nombres especificados con el valor especificado.
CreateAttributes()	Devuelve un XmlWriter objeto usado para crear nuevos atributos en el elemento actual.
CreateNavigator()	Devuelve una copia de .XPathNavigator
DeleteRange(XPathNavigator)	Elimina un intervalo de nodos del mismo nivel del nodo actual al nodo especificado.
DeleteSelf()	Elimina el nodo actual y sus nodos secundarios.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Evaluate(String, IXmlNamespaceResolver)	Evalúa la expresión XPath especificada y devuelve el resultado con tipo, utilizando el IXmlNamespaceResolver objeto especificado para resolver los prefijos de espacio de nombres en la expresión XPath.
Evaluate(String)	Evalúa la expresión XPath especificada y devuelve el resultado con tipo.
Evaluate(XPathExpression, XPathNodeIterator)	Usa el contexto proporcionado para evaluar y XPathExpressiondevuelve el resultado con tipo.
Evaluate(XPathExpression)	Evalúa y XPathExpression devuelve el resultado con tipo.
GetAttribute(String, String)	Obtiene el valor del atributo con el nombre local y el URI del espacio de nombres especificados.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetNamespace(String)	Devuelve el valor del nodo de espacio de nombres 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 XmlWriter objeto usado para crear un nuevo nodo relacionado después del nodo seleccionado actualmente.
InsertAfter(String)	Crea un nuevo nodo relacionado después del nodo seleccionado actualmente mediante la cadena XML especificada.
InsertAfter(XmlReader)	Crea un nuevo nodo relacionado después del nodo seleccionado actualmente mediante el contenido XML del XmlReader objeto especificado.
InsertAfter(XPathNavigator)	Crea un nuevo nodo relacionado después del nodo seleccionado actualmente mediante los nodos del XPathNavigator objeto especificado.
InsertBefore()	Devuelve un XmlWriter objeto usado para crear un nuevo nodo relacionado antes del nodo seleccionado actualmente.
InsertBefore(String)	Crea un nuevo nodo relacionado antes del nodo seleccionado actualmente mediante la cadena XML especificada.
InsertBefore(XmlReader)	Crea un nuevo nodo relacionado antes del nodo seleccionado actualmente mediante el contenido XML del XmlReader objeto especificado.
InsertBefore(XPathNavigator)	Crea un nuevo nodo relacionado antes del nodo seleccionado actualmente mediante los nodos del XPathNavigator especificado.
InsertElementAfter(String, String, String, String)	Crea un nuevo elemento relacionado después del nodo actual mediante el prefijo del espacio de nombres, el nombre local y el URI del espacio de nombres especificados, con el valor especificado.
InsertElementBefore(String, String, String, String)	Crea un nuevo elemento relacionado antes del nodo actual mediante el prefijo del espacio de nombres, el nombre local y el URI del espacio de nombres especificados, con el valor especificado.
IsDescendant(XPathNavigator)	Determina si el objeto especificado XPathNavigator es un descendiente del objeto actual XPathNavigator.
IsSamePosition(XPathNavigator)	Cuando se reemplaza en una clase derivada, determina si el actual XPathNavigator está en la misma posición que el especificado XPathNavigator.
LookupNamespace(String)	Obtiene el URI del espacio de nombres para el prefijo especificado.
LookupPrefix(String)	Obtiene el prefijo declarado para el 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 el especificado XPathExpression.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MoveTo(XPathNavigator)	Cuando se reemplaza en una clase derivada, mueve a XPathNavigator la misma posición que el especificado XPathNavigator.
MoveToAttribute(String, String)	Mueve al XPathNavigator atributo con el nombre local coincidente y el URI del espacio de nombres.
MoveToChild(String, String)	Mueve al XPathNavigator nodo secundario con el nombre local y el URI del espacio de nombres especificados.
MoveToChild(XPathNodeType)	Mueve al XPathNavigator nodo secundario del XPathNodeType especificado.
MoveToFirst()	Mueve el XPathNavigator al primer nodo hermano del nodo actual.
MoveToFirstAttribute()	Cuando se invalida en una clase derivada, mueve al XPathNavigator primer atributo del nodo actual.
MoveToFirstChild()	Cuando se reemplaza en una clase derivada, mueve al XPathNavigator primer nodo secundario del nodo actual.
MoveToFirstNamespace()	Mueve al XPathNavigator primer nodo de espacio de nombres del nodo actual.
MoveToFirstNamespace(XPathNamespaceScope)	Cuando se reemplaza en una clase derivada, mueve al XPathNavigator primer nodo de espacio de nombres que coincide con el XPathNamespaceScope especificado.
MoveToFollowing(String, String, XPathNavigator)	Mueve al XPathNavigator elemento con el nombre local y el URI del espacio de nombres especificados, al límite especificado, en orden de documento.
MoveToFollowing(String, String)	Mueve al XPathNavigator elemento con el nombre local y el URI del espacio de nombres especificados en el orden del documento.
MoveToFollowing(XPathNodeType, XPathNavigator)	Mueve al XPathNavigator siguiente elemento del XPathNodeType especificado, al límite especificado, en orden de documento.
MoveToFollowing(XPathNodeType)	Mueve al XPathNavigator siguiente elemento del especificado en orden de XPathNodeType 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)	Mueve al XPathNavigator nodo de espacio de nombres con el prefijo de espacio de nombres especificado.
MoveToNext()	Cuando se invalida en una clase derivada, mueve al XPathNavigator siguiente nodo relacionado del nodo actual.
MoveToNext(String, String)	Mueve al XPathNavigator siguiente nodo relacionado con el nombre local y el URI del espacio de nombres especificados.
MoveToNext(XPathNodeType)	Mueve al XPathNavigator siguiente nodo relacionado del nodo actual que coincide con el XPathNodeType especificado.
MoveToNextAttribute()	Cuando se invalida en una clase derivada, mueve al XPathNavigator atributo siguiente.
MoveToNextNamespace()	Mueve al XPathNavigator siguiente nodo de espacio de nombres.
MoveToNextNamespace(XPathNamespaceScope)	Cuando se invalida en una clase derivada, mueve al XPathNavigator siguiente nodo de espacio de nombres que coincida con el XPathNamespaceScope especificado.
MoveToParent()	Cuando se invalida en una clase derivada, mueve al XPathNavigator nodo primario del nodo actual.
MoveToPrevious()	Cuando se reemplaza en una clase derivada, mueve al XPathNavigator nodo relacionado anterior del nodo actual.
MoveToRoot()	Mueve al XPathNavigator nodo raíz al que pertenece el nodo actual.
PrependChild()	Devuelve un XmlWriter objeto usado 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 mediante 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 XmlReader objeto especificado.
PrependChild(XPathNavigator)	Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual mediante los nodos del XPathNavigator objeto especificado.
PrependChildElement(String, String, String, String)	Crea un nuevo elemento secundario al principio de la lista de nodos secundarios del nodo actual mediante el prefijo del espacio de nombres, el nombre local y el URI del espacio de nombres especificados con el valor especificado.
ReadSubtree()	Devuelve un XmlReader objeto que contiene el nodo actual y sus nodos secundarios.
ReplaceRange(XPathNavigator)	Reemplaza un intervalo de nodos del mismo nivel del nodo actual 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 XmlReader objeto especificado.
ReplaceSelf(XPathNavigator)	Reemplaza el nodo actual por el contenido del XPathNavigator objeto especificado.
Select(String, IXmlNamespaceResolver)	Selecciona un conjunto de nodos mediante la expresión XPath especificada con el IXmlNamespaceResolver objeto especificado para resolver los prefijos del espacio de nombres.
Select(String)	Selecciona un conjunto de nodos mediante la expresión XPath especificada.
Select(XPathExpression)	Selecciona un conjunto de nodos mediante el especificado XPathExpression.
SelectAncestors(String, String, Boolean)	Selecciona todos los nodos antecesores del nodo actual que tienen el nombre local y el URI de espacio de nombres especificados.
SelectAncestors(XPathNodeType, Boolean)	Selecciona todos los nodos antecesores del nodo actual que tienen una coincidencia XPathNodeType.
SelectChildren(String, String)	Selecciona todos los nodos secundarios del nodo actual que tienen el nombre local y el URI del espacio de nombres especificados.
SelectChildren(XPathNodeType)	Selecciona todos los nodos secundarios del nodo actual que tienen la coincidencia XPathNodeType.
SelectDescendants(String, String, Boolean)	Selecciona todos los nodos descendientes del nodo actual con el nombre local y el URI del espacio de nombres especificados.
SelectDescendants(XPathNodeType, Boolean)	Selecciona todos los nodos descendientes del nodo actual que tienen una coincidencia XPathNodeType.
SelectSingleNode(String, IXmlNamespaceResolver)	Selecciona un solo nodo en el XPathNavigator objeto utilizando la consulta XPath especificada con el IXmlNamespaceResolver objeto especificado para resolver los prefijos del espacio de nombres.
SelectSingleNode(String)	Selecciona un único nodo en mediante XPathNavigator la consulta XPath especificada.
SelectSingleNode(XPathExpression)	Selecciona un único nodo en mediante XPathNavigator el objeto especificado XPathExpression .
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, IXmlNamespaceResolver)	Obtiene el valor del nodo actual como se Type especifica, utilizando el IXmlNamespaceResolver objeto especificado para resolver los prefijos del espacio de nombres.
ValueAs(Type)	Devuelve el valor del elemento como el tipo especificado. (Heredado de XPathItem)
WriteSubtree(XmlWriter)	Transmite el nodo actual y sus nodos secundarios al XmlWriter objeto especificado.

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Crea una nueva copia del XPathNavigator objeto .

Consulte también

• IXPathNavigable
• XPathDocument
• XmlDocument
• XmlNode
• Procesar datos XML mediante el modelo de datos XPath