XPathNavigator Classe

Definição

Fornece um modelo de cursor para navegar e editar dados 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
Herança
XPathNavigator
Herança
XPathNavigator
Derivado
Implementações

Observações

A XPathNavigator classe no System.Xml.XPath namespace é uma classe abstrata que define um modelo de cursor para navegar e editar itens de informação XML como instâncias do Modelo de Dados XQuery 1.0 e XPath 2.0.

Um XPathNavigator objeto é criado a partir de uma classe que implementa a IXPathNavigable interface, como as XPathDocument classes e.XmlDocument XPathNavigator Os objetos criados por XPathDocument objetos são apenas de leitura, enquanto XPathNavigator os objetos criados por XmlDocument objetos podem ser editados. O estado de apenas leitura ou editável de um XPathNavigator objeto é determinado usando a CanEdit propriedade da XPathNavigator classe.

Para mais informações sobre o processamento de dados XML usando o modelo de dados XPath, consulte o tópico Processar Dados XML Usando o Modelo de Dados XPath .

Importante

Exceções levantadas como resultado do uso da XPathNavigator classe, como a XPathException classe, podem conter informações sensíveis que não devem ser expostas em cenários não confiáveis. As exceções devem ser tratadas adequadamente para que essas informações confidenciais não sejam expostas em cenários não confiáveis.

Notas para Implementadores

Quando herdas da XPathNavigator classe, deves sobrepor os seguintes membros:

Construtores

Name Description
XPathNavigator()

Inicializa uma nova instância da XPathNavigator classe.

Propriedades

Name Description
BaseURI

Quando é sobreposto numa classe derivada, obtém o URI base do nó atual.

CanEdit

Recebe um valor que indica se pode XPathNavigator editar os dados XML subjacentes.

HasAttributes

Recebe um valor que indica se o nó atual tem algum atributo.

HasChildren

Recebe um valor que indica se o nó atual tem algum nó filho.

InnerXml

Obtém ou define a marcação que representa os nós filhos do nó atual.

IsEmptyElement

Quando sobrescrito numa classe derivada, obtém um valor que indica se o nó atual é um elemento vazio sem etiqueta de elemento final.

IsNode

Recebe um valor que indica se o nó atual representa um nó XPath.

LocalName

Quando sobrescrito numa classe derivada, obtém o Name do nó atual sem qualquer prefixo de namespace.

Name

Quando sobrescrito numa classe derivada, obtém o nome qualificado do nó atual.

NamespaceURI

Quando é sobreposto numa classe derivada, obtém o URI do namespace do nó atual.

NameTable

Quando sobrescrito numa classe derivada, obtém o XmlNameTable de .XPathNavigator

NavigatorComparer

Obtém um IEqualityComparer uso para comparação de igualdade de XPathNavigator objetos.

NodeType

Quando sobrescrito numa classe derivada, obtém o XPathNodeType do nó atual.

OuterXml

Obtém ou define a marcação que representa as etiquetas de abertura e fecho do nó atual e dos seus nós filhos.

Prefix

Quando é sobreposto numa classe derivada, obtém o prefixo de namespace associado ao nó atual.

SchemaInfo

Obtém a informação do esquema que foi atribuída ao nó atual como resultado da validação do esquema.

TypedValue

Obtém o nó atual como um objeto em caixa do tipo .NET mais apropriado.

UnderlyingObject

Usado por XPathNavigator implementações que fornecem uma vista XML "virtualizada" sobre um armazenamento, para dar acesso a objetos subjacentes.

Value

Quando sobrescrito numa classe derivada, obtém o valor da cadeia do item.

Value

Quando é sobreposto numa classe derivada, obtém o string valor do item.

(Herdado de XPathItem)
ValueAsBoolean

Obtém o valor do nó atual como um Boolean.

ValueAsDateTime

Obtém o valor do nó atual como um DateTime.

ValueAsDouble

Obtém o valor do nó atual como um Double.

ValueAsInt

Obtém o valor do nó atual como um Int32.

ValueAsLong

Obtém o valor do nó atual como um Int64.

ValueType

Obtém o .NET Type do nó atual.

XmlLang

Obtém o xml:lang escopo para o nó atual.

XmlType

Obtém a XmlSchemaType informação do nó atual.

Métodos

Name Description
AppendChild()

Devolve um XmlWriter objeto usado para criar um ou mais novos nós filhos no final da lista de nós filhos do nó atual.

AppendChild(String)

Cria um novo nó filho no final da lista de nós filhos do nó atual usando a cadeia de dados XML especificada.

AppendChild(XmlReader)

Cria um novo nó filho no final da lista de nós filhos do nó atual usando o conteúdo XML do XmlReader objeto especificado.

AppendChild(XPathNavigator)

Cria um novo nó filho no final da lista de nós filhos do nó atual usando os nós especificados XPathNavigator .

AppendChildElement(String, String, String, String)

Cria um novo nó de elemento filho no final da lista de nós filhos do nó atual usando o prefixo do espaço de nomes, nome local e URI do espaço de nomes especificados com o valor especificado.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Verifica se os dados XML no XPathNavigator estão em conformidade com o esquema da linguagem de definição de esquemas XML (XSD) fornecido.

Clone()

Quando sobrescrito numa classe derivada, cria um novo XPathNavigator posicionado no mesmo nó que este XPathNavigator.

ComparePosition(XPathNavigator)

Compara a posição da corrente XPathNavigator com a posição do XPathNavigator especificado.

Compile(String)

Compila uma string que representa uma expressão XPath e devolve um XPathExpression objeto.

CreateAttribute(String, String, String, String)

Cria um nó de atributo no nó de elemento atual usando o prefixo do namespace, nome local e URI do namespace especificados com o valor especificado.

CreateAttributes()

Devolve um XmlWriter objeto usado para criar novos atributos no elemento atual.

CreateNavigator()

Devolve uma cópia do XPathNavigatorarquivo .

DeleteRange(XPathNavigator)

Elimina um intervalo de nós irmãos desde o nó atual até ao nó especificado.

DeleteSelf()

Elimina o nó atual e os seus nós filhos.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Evaluate(String, IXmlNamespaceResolver)

Avalia a expressão XPath especificada e retorna o resultado tipado, usando o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace na expressão XPath.

Evaluate(String)

Avalia a expressão XPath especificada e devolve o resultado tipado.

Evaluate(XPathExpression, XPathNodeIterator)

Utiliza o contexto fornecido para avaliar o XPathExpression, e devolve o resultado tipado.

Evaluate(XPathExpression)

Avalia o XPathExpression e devolve o resultado digitado.

GetAttribute(String, String)

Obtém o valor do atributo com o nome local especificado e o URI do espaço de nomes.

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetNamespace(String)

Devolve o valor do nó do namespace correspondente ao nome local especificado.

GetNamespacesInScope(XmlNamespaceScope)

Devolve os namespaces dentro do âmbito do nó atual.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InsertAfter()

Devolve um XmlWriter objeto usado para criar um novo nó irmão após o nó atualmente selecionado.

InsertAfter(String)

Cria um novo nó irmão após o nó atualmente selecionado usando a string XML especificada.

InsertAfter(XmlReader)

Cria um novo nó irmão após o nó atualmente selecionado usando o conteúdo XML do XmlReader objeto especificado.

InsertAfter(XPathNavigator)

Cria um novo nó irmão após o nó atualmente selecionado usando os nós no XPathNavigator objeto especificado.

InsertBefore()

Devolve um XmlWriter objeto usado para criar um novo nó irmão antes do nó atualmente selecionado.

InsertBefore(String)

Cria um novo nó irmão antes do nó atualmente selecionado usando a string XML especificada.

InsertBefore(XmlReader)

Cria um novo nó irmão antes do nó atualmente selecionado usando o conteúdo XML do XmlReader objeto especificado.

InsertBefore(XPathNavigator)

Cria um novo nó irmão antes do nó atualmente selecionado usando os nós especificados XPathNavigator .

InsertElementAfter(String, String, String, String)

Cria um novo elemento irmão após o nó atual usando o prefixo do namespace, nome local e URI do namespace especificados, com o valor especificado.

InsertElementBefore(String, String, String, String)

Cria um novo elemento irmão antes do nó atual usando o prefixo do namespace, nome local e URI do namespace especificados, com o valor especificado.

IsDescendant(XPathNavigator)

Determina se o especificado XPathNavigator é descendente do atual XPathNavigator.

IsSamePosition(XPathNavigator)

Quando sobrescrito numa classe derivada, determina se a corrente XPathNavigator está na mesma posição que a especificada XPathNavigator.

LookupNamespace(String)

Recebe o URI de namespace para o prefixo especificado.

LookupPrefix(String)

Obtém o prefixo declarado para o URI do namespace especificado.

Matches(String)

Determina se o nó atual corresponde à expressão XPath especificada.

Matches(XPathExpression)

Determina se o nó atual corresponde ao especificado XPathExpression.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MoveTo(XPathNavigator)

Quando sobrescrito numa classe derivada, move o XPathNavigator para a mesma posição que a especificada XPathNavigator.

MoveToAttribute(String, String)

Move o XPathNavigator para o atributo com o nome local correspondente e o URI do espaço de nomes.

MoveToChild(String, String)

Move o XPathNavigator para o nó filho com o nome local e o URI do espaço de nomes especificados.

MoveToChild(XPathNodeType)

Move o XPathNavigator para o nó filho do XPathNodeType especificado.

MoveToFirst()

Move o XPathNavigator para o primeiro nó irmão do nó atual.

MoveToFirstAttribute()

Quando sobrescrito numa classe derivada, move o XPathNavigator para o primeiro atributo do nó atual.

MoveToFirstChild()

Quando sobreposto numa classe derivada, move o XPathNavigator para o primeiro nó filho do nó atual.

MoveToFirstNamespace()

Move o XPathNavigator nó para o primeiro namespace do nó atual.

MoveToFirstNamespace(XPathNamespaceScope)

Quando é sobreposto numa classe derivada, move o XPathNavigator para o primeiro nó de namespace que corresponde ao XPathNamespaceScope especificado.

MoveToFollowing(String, String, XPathNavigator)

Move o XPathNavigator para o elemento com o nome local e o URI do espaço de nomes especificados, para a fronteira especificada, por ordem do documento.

MoveToFollowing(String, String)

Move o XPathNavigator para o elemento com o nome local e o URI do espaço de nomes especificados na ordem do documento.

MoveToFollowing(XPathNodeType, XPathNavigator)

Move o XPathNavigator para o seguinte elemento do XPathNodeType especificado, para o limite especificado, por ordem do documento.

MoveToFollowing(XPathNodeType)

Move o XPathNavigator para o elemento seguinte do XPathNodeType especificado na ordem do documento.

MoveToId(String)

Quando sobrescrito numa classe derivada, move-se para o nó que tem um atributo de tipo ID cujo valor corresponde ao especificado String.

MoveToNamespace(String)

Move o XPathNavigator para o nó de espaço de nomes com o prefixo especificado.

MoveToNext()

Quando sobreposto numa classe derivada, move o XPathNavigator para o nó irmão seguinte do nó atual.

MoveToNext(String, String)

Move o XPathNavigator para o próximo nó irmão com o nome local e o URI do espaço de nomes especificados.

MoveToNext(XPathNodeType)

Move o XPathNavigator para o próximo nó irmão do nó atual que corresponde ao XPathNodeType especificado.

MoveToNextAttribute()

Quando é sobreposto numa classe derivada, move o XPathNavigator para o atributo seguinte.

MoveToNextNamespace()

Move o XPathNavigator para o próximo nó de namespace.

MoveToNextNamespace(XPathNamespaceScope)

Quando é sobreposto numa classe derivada, move o XPathNavigator para o próximo nó de namespace que corresponde ao XPathNamespaceScope especificado.

MoveToParent()

Quando sobrescrito numa classe derivada, move o XPathNavigator para o nó pai do nó atual.

MoveToPrevious()

Quando sobreposto numa classe derivada, move o XPathNavigator para o nó irmão anterior do nó atual.

MoveToRoot()

Move o XPathNavigator para o nó raiz ao qual pertence o nó atual.

PrependChild()

Devolve um XmlWriter objeto usado para criar um novo nó filho no início da lista de nós filhos do nó atual.

PrependChild(String)

Cria um novo nó filho no início da lista de nós filhos do nó atual usando a string XML especificada.

PrependChild(XmlReader)

Cria um novo nó filho no início da lista de nós filhos do nó atual usando o conteúdo XML do XmlReader objeto especificado.

PrependChild(XPathNavigator)

Cria um novo nó filho no início da lista de nós filhos do nó atual usando os nós no XPathNavigator objeto especificado.

PrependChildElement(String, String, String, String)

Cria um novo elemento filho no início da lista de nós filhos do nó atual usando o prefixo do espaço de nomes, o nome local e o URI do espaço de nomes especificados com o valor especificado.

ReadSubtree()

Devolve um XmlReader objeto que contém o nó atual e os seus nós filhos.

ReplaceRange(XPathNavigator)

Substitui um conjunto de nós irmãos do nó atual para o nó especificado.

ReplaceSelf(String)

Substitui o nó atual pelo conteúdo da cadeia especificada.

ReplaceSelf(XmlReader)

Substitui o nó atual pelo conteúdo do XmlReader objeto especificado.

ReplaceSelf(XPathNavigator)

Substitui o nó atual pelo conteúdo do XPathNavigator objeto especificado.

Select(String, IXmlNamespaceResolver)

Seleciona um conjunto de nós usando a expressão XPath especificada com o IXmlNamespaceResolver objeto especificado para resolver prefixos de espaço de nomes.

Select(String)

Seleciona um conjunto de nós, usando a expressão XPath especificada.

Select(XPathExpression)

Seleciona um conjunto de nós usando o especificado XPathExpression.

SelectAncestors(String, String, Boolean)

Seleciona todos os nós ancestrais do nó atual que tenham o nome local e o espaço de nomes URI especificados.

SelectAncestors(XPathNodeType, Boolean)

Seleciona todos os nós ancestrais do nó atual que tenham uma correspondência XPathNodeType.

SelectChildren(String, String)

Seleciona todos os nós filhos do nó atual que têm o nome local e o URI do espaço de nomes especificados.

SelectChildren(XPathNodeType)

Seleciona todos os nós filhos do nó atual que têm a correspondência XPathNodeType.

SelectDescendants(String, String, Boolean)

Seleciona todos os nós descendentes do nó atual com o nome local e o URI do espaço de nomes especificados.

SelectDescendants(XPathNodeType, Boolean)

Seleciona todos os nós descendentes do nó atual que tenham um correspondente XPathNodeType.

SelectSingleNode(String, IXmlNamespaceResolver)

Seleciona um único nó no XPathNavigator objeto usando a consulta XPath especificada com o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace.

SelectSingleNode(String)

Seleciona um único nó em usando XPathNavigator a consulta XPath especificada.

SelectSingleNode(XPathExpression)

Seleciona um único nó em usando XPathNavigator o objeto especificado XPathExpression .

SetTypedValue(Object)

Define o valor tiposado do nó atual.

SetValue(String)

Define o valor do nó atual.

ToString()

Obtém o valor de texto do nó atual.

ValueAs(Type, IXmlNamespaceResolver)

Obtém o valor do nó atual como Type especificado, usando o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace.

ValueAs(Type)

Devolve o valor do artigo como o tipo especificado.

(Herdado de XPathItem)
WriteSubtree(XmlWriter)

Transmite o nó atual e os seus nós filhos para o XmlWriter objeto especificado.

Implementações de Interface Explícita

Name Description
ICloneable.Clone()

Cria uma nova cópia do XPathNavigator objeto.

Aplica-se a

Ver também